.env.example

MINIMAX_API_KEY=
OPENAI_API_KEY=
ANTHROPIC_API_KEY=

# Optional: override the User-Agent header Zeus sends when running
# webSearch. DuckDuckGo occasionally throttles unfamiliar agents; set
# this to a real browser UA if you start seeing 403s.
# ZEUS_SEARCH_USER_AGENT=Mozilla/5.0 ...

# Search backend for the webSearch tool.
#
#   ddgs (default on installed builds) — the Zeus installer ships a
#     self-contained `ddgs.exe` sidecar (Python + ddgs + curl-cffi
#     bundled) next to zeus.exe, so no host Python is needed. The
#     sidecar mimics a real-browser TLS fingerprint and bypasses DDG's
#     bot challenge. No API key.
#   searxng — point ZEUS_SEARXNG_URL at a self-hosted SearXNG instance
#     with JSON output enabled.
#   duckduckgo — raw HTML scrape against html.duckduckgo.com. Frequently
#     CAPTCHA'd from consumer IPs; use only as a last-resort fallback.
#
# When unset, Zeus auto-detects: ddgs sidecar (if present) → searxng (if
# ZEUS_SEARXNG_URL is set) → duckduckgo. If the auto-detected provider
# errors out at runtime, Zeus retries the next provider in the chain
# so a single transient failure doesn't break the agent loop.
#
# ZEUS_SEARCH_PROVIDER=ddgs
# ZEUS_SEARXNG_URL=https://searx.example.com

# Override the ddgs sidecar path. Normally unnecessary — Zeus finds the
# bundled sidecar next to zeus.exe automatically. Set this only if you
# want to use a custom-built ddgs (e.g. pinned ddgs version, musl build).
# ZEUS_DDGS_BIN=/path/to/ddgs

# Skills catalog allowlist. Comma-separated list of skill IDs that
# should always appear in the Skills picker. Anything not on the list
# is hidden from the picker but still loadable on demand via the
# `load_skill` command (e.g. by slash-typing its id). Useful for
# trimming a large skills dir down to a starter set.
# ZEUS_BUNDLED_SKILLS=tools/grep,writing/commit-message

# Tested ~40 public SearXNG instances (searx.space top-ranked, 2026-07-08):
# none returned JSON from residential/mobile IPs — they all rate-limit
# shared ranges with 429 or hit visitors with Anubis/Cloudflare bot
# challenges. If you only have a consumer ISP IP, you MUST self-host
# or use a paid API. Run `bash scripts/start-searxng-docker.sh` to spin
# up a local instance on http://localhost:8888, then set
# ZEUS_SEARXNG_URL=http://localhost:8888.