.env.example
Set these on your host before deploying. Each platform has an “Environment Variables” section in the deploy flow.
API_FOOTBALL_KEY
secret
── Data providers ────────────────────────────────────────────────────────────── API-Football (v3) — https://v3.football.api-sports.io Free…
API_FOOTBALL_LEAGUE_ID
WC 2026 league ID in API-Football. Run: curl -s "https://v3.football.api-sports.io/leagues?type=cup&name=World+Cup" \ -H "x-apisports-key:…
API_FOOTBALL_SEASON
OPENFOOTBALL_URL
Openfootball (no key required)
ODDS_API_KEY
secret
The Odds API (optional, for market-based model blending) https://the-odds-api.com
SIM_COUNT
── Simulation ─────────────────────────────────────────────────────────────────── Number of Monte Carlo iterations (10000 default; up to…
SIM_SEED
Fixed seed for reproducible runs. Leave blank to use timestamp-based seed.
MODEL_TYPE
Model: "poisson" (default) or "elo"
BASE_GOALS_RATE
Base expected goals per team per match (WC historical average ~1.25)
HOST_ADJUSTMENT
Multiplier for matches where a hosting nation (USA/CAN/MEX) plays at home
BLEND_ODDS_WEIGHT
Weight blending market implied probabilities into ratings. 0 = off, 1 = full market.
OUTPUT_DIR
── Paths ───────────────────────────────────────────────────────────────────────── Override where the job writes JSON artifacts (defaults…
CACHE_DIR
Override where raw API responses are cached (defaults to job/cache)
USE_MOCK
── Flags ──────────────────────────────────────────────────────────────────────── Set to "true" to use mock data instead of calling APIs…
brew install flyctl && fly launch --from https://github.com/abhirup780/wc-2026curl -L https://fly.io/install.sh | sh && fly launch --from https://github.com/abhirup780/wc-2026iwr https://fly.io/install.ps1 -useb | iex; fly launch --from https://github.com/abhirup780/wc-2026