.env.example

# REQUIRED
CHESS_USERNAME=your_chesscom_username
CHESS_OUTPUT_DIR=/data
STATE_DB=/data/state.sqlite
# Your local timezone (e.g. America/Chicago, Europe/London)
DISPLAY_TIMEZONE=America/Chicago

# Optional container UID/GID mapping (Linux hosts)
UID=1000
GID=1000

# LLM provider: "gpt" or "ollama"
PROVIDER=ollama

# Postgres connection string (used by default in docker-compose)
# Postgres in docker-compose (auto default if omitted)
DATABASE_URL=postgresql://chess:chess@postgres:5432/chesscoach

# Telegram (optional)
TG_BOT_TOKEN=
TG_CHAT_ID=

# OpenAI (optional)
# OPENAI_API_KEY=

# Ollama (optional)
# Set this explicitly when PROVIDER=ollama.
# In Docker, prefer host.docker.internal to reach host Ollama.
# Ollama base URL (use host.docker.internal in Docker to reach host)
OLLAMA_URL=http://host.docker.internal:11434
# Example: llama3.2:latest, qwen2.5:14b-instruct
OLLAMA_MODEL=llama3.2:latest

# LLM tuning (applies to Ollama or GPT provider)
LLM_TEMPERATURE=0.1
LLM_TOP_P=0.8
LLM_MAX_TOKENS=600
LLM_TIMEOUT_SECONDS=300

# PGN retry behavior
PGN_FETCH_MAX_ATTEMPTS=5
PGN_FETCH_TERMINAL_ATTEMPTS=10

# Engine / analysis settings
ENABLE_ENGINE=true
STOCKFISH_PATH=/usr/games/stockfish
ENGINE_DEPTH=15
# Polling / retry controls
POLL_MAX_ATTEMPTS=5
POLL_COOLDOWN_SECONDS=600
POLL_BATCH_SIZE=5
ENABLE_QUEUE_DEBUG=0
ENABLE_POLL_EXEC_AUDIT=0
PROCESS_ON_STARTUP=true
PLAYER_SUMMARY_EVERY_N=20