config.env.example

# ═══ Eternal Nagual — configuration ═══
# Copy to config.env and fill in. At least ONE LLM provider key is required.
# config.env is baked into the container at build time and is .gitignore'd — never commit it.

# ── Telegram (the agent's voice to its architect) ──
TG_TOKEN=                    # BotFather token; leave empty to run without Telegram
TG_CHAT_ID=                  # your chat id with the bot
OWNER_CHAT_ID=               # fallback owner id (usually same as TG_CHAT_ID)

# ── LLM providers (any subset; the router cascades across whatever you give it) ──
NVIDIA_API_KEY=              # build.nvidia.com — generous free tier, the default workhorse
GOOGLE_API_KEY=              # aistudio.google.com — Gemini free tier
OPENROUTER_API_KEY=          # openrouter.ai — :free models = the never-down floor
ANTHROPIC_API_KEY=           # THE WAKE-UP KEY: give it Claude and the meta-layer comes alive
OPENAI_API_KEY=
XAI_API_KEY=
DEEPSEEK_API_KEY=
MOONSHOT_API_KEY=
MIMO_API_KEY=

# ── Model role pins (optional; sensible defaults in code) ──
PRIMARY_MODEL=               # e.g. mistralai/mistral-small-4-119b-2603 (fast voice)
PRIMARY_PROVIDER=            # e.g. nvidia
GUARD_MODEL=                 # safety-judge model
GUARD_PROVIDER=
FALLBACK_MODEL=
FALLBACK_PROVIDER=

# ── Web search ──
BRAVE_API_KEY=               # brave.com/search/api free tier; auto-falls back to DuckDuckGo

# ── Voice (optional) ──
ELEVEN_API_KEY=              # elevenlabs.io — voice replies in Telegram
ELEVEN_VOICE_ID=

# ── Social life (optional) ──
MOLTHBOOK_API_KEY=           # moltbook.com — the social network for AI agents

# ── Memory cocoon (optional but recommended: private git repo for its state) ──
GITHUB_REPO=                 # e.g. git@github.com:you/nagual-memory.git (PRIVATE!)
GITHUB_SSH_REMOTE=

# ── Advanced model pins (optional) ──
ORCH_MODEL=                  # meta-layer brain (orchestrator/judge/forge) — put your strongest model here
MOLTBOOK_MODEL=              # social-content model

# ── Misc ──
TZ=Europe/Moscow             # the agent's local clock
BG_LLM_PER_MIN=              # background LLM call budget per minute (default in code)
WEBHOOK_URL=                 # outbound event webhook (optional)
SELF_HOST_IP=                # your VPS public IP — used only by the leak filter to scrub it from output