What is fifa-world-cup-2026-prediction-agent?

This is a command-line tool written in TypeScript that predicts match outcomes for the FIFA World Cup 2026. It uses a combination of three statistical models to generate its predictions: an Elo rating system (which tracks team strength over time based on past results), a Poisson model (which estimates how many goals each team is likely to score based on their attack and defense records), and a form model (which weights recent performance more heavily). Results from all three are blended into a single probability for each match. For any given match, the tool outputs the probability of a home win, draw, or away win, along with an expected goal count. Beyond individual matches, it can simulate the entire group stage to project standings, run a full tournament bracket to project a likely champion, and flag potential value bets by comparing its own probability estimates against real betting market odds. An optional AI hybrid mode lets you feed the statistical output through an LLM (using an OpenAI-compatible API key) to layer in qualitative reasoning about things like team tactics, injury news, or host-country pressure. You can control how much weight the AI opinion carries relative to the statistical baseline. Six named configuration profiles let you shift the model toward different betting strategies: one optimized for goal totals, one that leans heavily on Elo rankings for clear favorites, one that tracks form streaks, and one that applies a home-field bonus for the USA, Mexico, and Canada venues. The tool also supports predictions for domestic club fixtures (not just World Cup matches) by pulling historical match data from CSV files for England, Spain, Italy, Germany, and France. A Redis cache is available to avoid recomputing the same predictions repeatedly. Node.js 20 or newer is required.