.env.example

# Copy to .env and adjust before `docker compose up`.
# Keep .env out of source control; it is listed in .gitignore.

# ── Provider selection ───────────────────────────────────────────────────────
# Chat and embeddings are chosen independently.
#   AI_CHAT_PROVIDER:      Ollama | AzureOpenAI
#   AI_EMBEDDING_PROVIDER: Ollama | AzureOpenAI | Deterministic
#
# Deterministic embeddings are local hashed bag-of-words vectors — no model, no cost, good
# enough for testing retrieval plumbing. There is no equivalent for chat: the agent needs a
# real model to decide which tools to call.
AI_CHAT_PROVIDER=Ollama
AI_EMBEDDING_PROVIDER=Ollama

# ── Ollama (local) ───────────────────────────────────────────────────────────
# From inside a container, reach the host's Ollama at host.docker.internal.
# The chat model MUST support tool calling: qwen2.5, llama3.1, llama3.2, mistral-nemo do.
OLLAMA_ENDPOINT=http://host.docker.internal:11434/v1
OLLAMA_CHAT_MODEL=qwen2.5:14b
OLLAMA_EMBEDDING_MODEL=nomic-embed-text
# Must match the model exactly: nomic-embed-text 768, mxbai-embed-large 1024, all-minilm 384.
OLLAMA_EMBEDDING_DIMENSIONS=768

# ── Azure OpenAI ─────────────────────────────────────────────────────────────
# Only needed when a provider above is set to AzureOpenAI.
AZURE_OPENAI_ENDPOINT=
# Leave the key empty to authenticate with DefaultAzureCredential instead, which is the
# better option outside local development.
AZURE_OPENAI_API_KEY=
AZURE_OPENAI_CHAT_DEPLOYMENT=gpt-4o-mini
AZURE_OPENAI_EMBEDDING_DEPLOYMENT=text-embedding-3-small
# text-embedding-3-small 1536, text-embedding-3-large 3072.
AZURE_OPENAI_EMBEDDING_DIMENSIONS=1536

# ── Infrastructure ───────────────────────────────────────────────────────────
# Host port for Postgres. 55433 by default to avoid clashing with a local install.
POSTGRES_PORT=55433