dxboy266/fifa-winner-skill

This is a Python-based World Cup 2026 prediction tool that blends sports statistics with Chinese astrology for entertainment purposes. The author named the main script after Paul the Octopus, the famous prediction mascot from the 2010 World Cup. The core prediction logic uses what the README calls a Tri-Track Collision model. Three separate signals are calculated independently and combined. The first track uses hard statistics: FIFA rankings, squad depth, historical head-to-head records, and physical fitness data, weighted at 60% of the final score. The second track pulls live betting market odds, converts them into implied win probabilities, and compares them to the statistical score. When both tracks agree, the prediction is labeled resonant (higher confidence), when they contradict each other, a divergence warning flags possible upsets. The third track is an astrological timing layer based on classical Chinese divination texts, where star positions at kickoff time map to momentum bonuses or penalties. The README is clear this track is purely for entertainment storytelling and carries 40% of the final blend. On top of the prediction engine, the tool includes a ReAct agent loop that can break multi-step analysis tasks into sequential steps automatically, and a self-reflection module that reviews past predictions after matches and adjusts the model's internal weights. The outputs include a static dashboard deployed to GitHub Pages via GitHub Actions, and a social media feature that generates share-ready text and image prompts formatted for Midjourney or DALL-E. The project explicitly states it is for entertainment only and must not be used for betting or financial decisions. That disclaimer appears multiple times in the README.