.env.example

# Agent Zero -- environment configuration
# Copy this file to .env and fill in your values.
# .env is gitignored and never committed.

# ---- Models ---------------------------------------------------------------
# Swap for smaller models on limited hardware (e.g. gemma2:2b, phi3:mini)
MAIN_MODEL=gemma4:26b
FAST_MODEL=gemma4:e2b
VOICE_MODEL=gemma4:e4b
REASONING_MODEL=llama3.3:70b
CODE_MODEL=qwen3-coder:30b
VISION_MODEL=qwen3-vl:30b
FINETUNE_MODEL=gemma4:e4b

# ---- Ollama ---------------------------------------------------------------
OLLAMA_BASE_URL=http://localhost:11434

# ---- Ollama Cloud (optional) ----------------------------------------------
# Set OLLAMA_PROVIDER=cloud to route all LLM inference to Ollama cloud.
# Leave unset or "local" to use local Ollama (default behavior).
# Toggle at runtime via: 'local' / 'cloud' CLI commands or UI button.
# OLLAMA_PROVIDER=cloud
# OLLAMA_CLOUD_URL=https://api.ollama.com
# OLLAMA_CLOUD_API_KEY=your_ollama_cloud_api_key_here

# Cloud model name overrides (fall back to local model names if not set)
# CLOUD_CHAT_MODEL=
# CLOUD_KB_REFINE_MODEL=
# CLOUD_FAST_MODEL=
# CLOUD_VOICE_MODEL=

# Route embeddings (nomic-embed-text) through cloud provider when OLLAMA_PROVIDER=cloud.
# Same model = same vector space = no ChromaDB re-index needed. Off by default (privacy).
# EMBED_FOLLOWS_PROVIDER=false

# ---- Paths (relative to project root) -------------------------------------
AGENT_DB_PATH=data/agent_memory.db
CHROMA_DB_PATH=data/chroma_db
TXTAI_DB_PATH=data/txtai_db

# ---- Local API ------------------------------------------------------------------
# Generate a token: python -c "import secrets; print(secrets.token_urlsafe(32))"
# Minimum 32 characters. This is the only credential protecting the local API.
API_TOKEN=replace_this_with_a_real_token_min_32_chars
API_PORT=8900

# ---- Bridge ---------------------------------------------------------------
PROJECT_OUTPUTS_PATH=project_outputs
CLAUDE_MD_MAX_CHARS=65536

# ---- Voice (macOS only) ---------------------------------------------------
WHISPER_MODEL=distil-large-v3
TTS_VOICE=Samantha
TTS_RATE=175
VAD_THRESHOLD=0.5
VAD_SILENCE_MS=1000
MAX_SPEECH_SECONDS=30
VOICE_LANGUAGE=en
VOICE_MIN_RMS=0.01
VOICE_CHUNK_SECONDS=3
VOICE_INPUT_GAIN=1.0

# ---- Telemetry ------------------------------------------------------------
# LangSmith tracing is disabled by default. Uncomment and add a key to enable.
LANGCHAIN_TRACING_V2=false
# LANGCHAIN_API_KEY=your_langsmith_api_key