.env.example
Set these on your host before deploying. Each platform has an “Environment Variables” section in the deploy flow. (showing first 20, more exist in .env.example)
GROQ_API_KEY
secret
Groq API (primary — 14,400 req/day on free tier) Get yours at: https://console.groq.com/
OPENROUTER_API_KEY
secret
OpenRouter API (fallback — 50 req/day on free tier) Get yours at: https://openrouter.ai/
FORECAST_LLM_PROVIDER_ORDER
Optional: forecast enrichment model routing Defaults stay unchanged unless you set these. Precedence: combined-stage override ->…
FORECAST_LLM_MODEL_OPENROUTER
FORECAST_LLM_COMBINED_PROVIDER_ORDER
FORECAST_LLM_COMBINED_MODEL_OPENROUTER
FORECAST_LLM_CRITICAL_PROVIDER_ORDER
FORECAST_LLM_CRITICAL_MODEL_OPENROUTER
FORECAST_LLM_MARKET_IMPLICATIONS_PROVIDER_ORDER
FORECAST_LLM_MARKET_IMPLICATIONS_MODEL_OPENROUTER
UPSTASH_REDIS_REST_URL
Used to deduplicate AI calls and cache risk scores across visitors. Create a free Redis database at: https://upstash.com/
UPSTASH_REDIS_REST_TOKEN
secret
REDIS_PASSWORD
secret
REQUIRED when running via docker-compose.yml. Both containers fail to start if either variable is unset (no shipped defaults — see #3804).…
REDIS_TOKEN
secret
FINNHUB_API_KEY
secret
Finnhub (primary stock quotes — free tier available) Register at: https://finnhub.io/
EIA_API_KEY
secret
U.S. Energy Information Administration (oil prices, production, inventory) Register at: https://www.eia.gov/opendata/
FRED_API_KEY
secret
FRED (Federal Reserve Economic Data) Register at: https://fred.stlouisfed.org/docs/api/api_key.html
IMF_API_KEY
secret
IMF SDMX API (WEO, IRFCL gold reserves, national debt) Currently OPTIONAL but recommended — IMF allows unauthenticated requests today, but…
OPENAQ_API_KEY
secret
OpenAQ API v3 (required for scripts/seed-health-air-quality.mjs) Register at: https://docs.openaq.org/using-the-api/api-key
WAQI_API_KEY
secret
WAQI API (optional supplement for additional city/station coverage) Register at: https://aqicn.org/data-platform/token/