.env.example

# Copy to .env at the repository root for shared provider-aware chapter CLIs.
# Some experiments load an adjacent .env or expect exported environment vars;
# follow the experiment README when it gives narrower setup instructions.
#
#     cp .env.example .env
#
# Set whichever provider you actually use -- you do not need all of them.

# --- zero-cost options -------------------------------------------------------

# 1. OpenRouter with a free model. Runs on OpenRouter's servers, so any laptop
#    works. Model ids ending in ':free' cost nothing.
# Uncomment and paste your key after `=`.
# OPENROUTER_API_KEY=
OPENROUTER_MODEL=google/gemma-4-31b-it:free

# 2. Ollama. Fully local, no key and no network, but needs enough RAM to hold
#    the model. Use `--provider ollama` in the chapter CLIs.
# OLLAMA_BASE_URL=http://localhost:11434/v1

# --- direct provider keys ----------------------------------------------------
# Any one of these is enough; the chapter picks a provider and falls back to
# OpenRouter when that provider's key is absent.

# Moonshot / Kimi -- required for chapter 1's live $web_search experiment,
# which OpenRouter cannot substitute.
# MOONSHOT_API_KEY=your-moonshot-key

# ByteDance Doubao (Volcano Engine)
# ARK_API_KEY=your-ark-key

# SiliconFlow (Qwen)
# SILICONFLOW_API_KEY=your-siliconflow-key

# Alibaba Cloud Model Studio / Bailian (Qwen)
# Mainland-region key:
# DASHSCOPE_API_KEY=your-dashscope-key
# International-region key (use this endpoint with an international key):
# DASHSCOPE_BASE_URL=https://dashscope-intl.aliyuncs.com/compatible-mode/v1

# DeepSeek
# DEEPSEEK_API_KEY=your-deepseek-key
# DEEPSEEK_BASE_URL=https://api.deepseek.com

# Zhipu (GLM)
# ZHIPU_API_KEY=your-zhipu-key

# OpenAI
# OPENAI_API_KEY=your-openai-api-key

# Google Gemini (has a free tier)
# GEMINI_API_KEY=your-gemini-key