.env.example

# Volo environment variables. Copy to `.env` and fill in.
# Twelve-factor: never hardcode secrets; everything flows through env vars.

# --- core ---
VOLO_DATA_DIR=./.volo                    # where recordings + sqlite live
VOLO_LOG_LEVEL=info                          # trace | debug | info | warn | error

# --- API service ---
VOLO_API_HOST=127.0.0.1
VOLO_API_PORT=8080

# --- web dashboard ---
NEXT_PUBLIC_VOLO_API=http://localhost:8080

# --- models / cost control (all optional) ---
# Local default: Ollama. No keys needed.
OLLAMA_HOST=http://localhost:11434
OLLAMA_JUDGE_MODEL=llama3.2:3b

# Free OpenAI-compatible judge (Groq by default; also Gemini / OpenRouter — ADR-0011).
# Opt-in flag gates live calls; cost is $0. Use with `volo run … --judge groq`.
VOLO_OPENAI_COMPAT_OPT_IN=false
GROQ_API_KEY=                                # get a free key at https://console.groq.com
# GEMINI_API_KEY=
# OPENROUTER_API_KEY=

# Frontier API providers (PAID) — opt-in only. The CLI refuses to use these unless
# VOLO_FRONTIER_OPT_IN=true and a per-project cap is set.
VOLO_FRONTIER_OPT_IN=false
VOLO_FRONTIER_MAX_USD=0.00
# ANTHROPIC_API_KEY=sk-ant-...
# OPENAI_API_KEY=sk-...