Heoshua déploie son premier outil : un tracker live pour la World Cup 2026
Notre tout premier outil public est en ligne — un bot Telegram qui suit votre soumission au Zindi WC2026 Goal Prediction Challenge en direct : RMSE, F1, classement et alertes de but.
Big things start small.
Aujourd'hui, Heoshua déploie son tout premier outil public : un bot Telegram qui suit votre soumission au Zindi World Cup 2026 Goal Prediction Challenge en direct — match après match, but après but, alerte après alerte.
Le problème
La structure de ce challenge est singulière. Vous entraînez vos modèles sur des données historiques, vous construisez vos prédictions — puis les soumissions sont verrouillées le 19 juin 2026, juste avant le coup d'envoi du tournoi. À partir de ce moment, vous ne pouvez plus rien changer.
Le tournoi se déroule ensuite sur 104 matchs et six semaines, de début juin à mi-juillet. Le leaderboard Zindi se met à jour périodiquement — mais sans granularité, sans transparence, sans que vous sachiez quel match a fait bouger votre score, ni dans quel sens.
Pendant toute la Coupe du Monde, vous êtes dans le noir. Votre RMSE monte-t-il ou descend-il ? Avez-vous remonté le classement depuis hier ? Impossible à savoir — jusqu'à maintenant.
Ce que fait le tracker
Le bot rejoue votre soumission contre les résultats réels du tournoi en temps réel. À chaque but validé et à chaque coup de sifflet final, il recalcule et vous pousse directement dans Telegram :
- RMSE sur les buts cumulés prédits par équipe — 60 % du score final
- Macro F1 sur les sept stades de sortie (groupe, huitièmes, quarts, demies, troisième place, finale, champion) — 40 % du score
- Votre score combiné
0,6 × RMSE + 0,4 × F1et votre rang dans la cohorte, en direct - Une alerte personnalisée à chaque but et chaque fin de match, avec l'impact chiffré sur vos métriques
Résultat : au lieu d'attendre une mise à jour opaque du leaderboard, vous savez exactement pourquoi votre score a bougé — et de combien.
On voulait un outil qu'on utiliserait nous-mêmes pendant la compétition. Le voilà — et il est ouvert à tous.
L'interface : tout en commandes Telegram
Pas d'application à installer, pas de compte à créer. Tout se pilote depuis Telegram avec huit commandes :
/setname— choisissez votre nom de classement (requis avant toute autre commande)/upload— envoyez votre soumission CSV ; le bot la valide et la stocke/me— votre RMSE, F1 et rang en direct, à tout moment/rank— le classement général en temps réel/team <ISO3>— statut d'une équipe et votre pronostic sur elle/today·/yesterday— les matchs du jour et de la veille/scorers— les meilleurs buteurs du tournoi/standings [groupe]— les classements des groupes
Trois étapes pour commencer : démarrez le bot, choisissez votre nom avec /setname, envoyez votre CSV avec /upload. Ensuite, le bot tourne seul jusqu'au 19 juillet.
Ce que construire ça nous a appris
Ce tracker paraît simple de l'extérieur. Il ne l'était pas.
Rejouer une soumission en live. Les prédictions sont figées, mais le tournoi avance continuellement. Chaque but modifie les buts cumulés par équipe et potentiellement le stade de sortie pronostiqué. Il faut recalculer les métriques à chaque événement de façon idempotente — sans que les données d'un match polluent le calcul du suivant.
Gérer les soumissions multiples. Un compétiteur peut charger plusieurs versions de son CSV avant la date limite. Le bot accepte la dernière version valide et archive les précédentes sans les écraser, pour rendre les recalculs rétrospectifs possibles.
Calibrer les alertes. Trop d'alertes, personne ne les lit. Trop peu, l'outil perd sa valeur. On a choisi : alerte à chaque but (impact immédiat sur le RMSE) et alerte à chaque fin de match (impact sur le F1 et le rang global). Pas plus.
Et après
Ce bot est la première pierre visible de ce que nous construisons : des outils nés de la compétition, affinés par la pratique, ouverts à la communauté.
Le code source est ouvert sur GitHub — vous pouvez l'auditer, le forker, proposer des améliorations. Les apprentissages techniques détaillés (architecture, calcul des métriques, gestion des événements Telegram, replay des soumissions) feront l'objet d'un article dédié dans le Journal.
Le tournoi dure jusqu'au 19 juillet 2026. D'ici là, on suit, on mesure, on publie. Chaque outil qu'on construit nourrit le suivant.
Big things start small.
Mise à jour · Juin 2026 — Le classement passe sur le web
Depuis le lancement, un retour est revenu plusieurs fois dans les discussions : Telegram est payant dans certaines régions, et certains participants préféraient suivre leur score sans créer de compte. C'est maintenant possible.
Un classement web sans Telegram
La page heoshua.com/fr/tool/wc2026 propose désormais :
- Un classement en direct — mis à jour toutes les 60 secondes depuis la même API que le bot Telegram.
- Upload CSV web — déposez votre fichier directement sur la page, entrez un nom de classement (2–32 caractères), et obtenez votre RMSE, F1 et rang en quelques secondes. Aucun compte requis — une session est stockée dans votre navigateur.
- Partager son rang — un bouton copie un extrait texte formaté prêt à coller : rang, RMSE, F1, et le lien vers le classement.
Ce qui reste dans Telegram
Les alertes à chaque but et fin de match continuent à transiter par Telegram — c'est là où la valeur temps-réel est la plus forte. Le web prend en charge tout le reste : consultation, upload, classement, et retour étoiles.
Architecture
L'API FastAPI qui alimente le bot expose maintenant POST /upload, GET /me, GET /leaderboard, POST /feedback et GET /feedback/summary. Les requêtes SQLite depuis les handlers async FastAPI passent par asyncio.to_thread avec check_same_thread=False. Le frontend Next.js consomme ces endpoints via NEXT_PUBLIC_BOT_API_URL côté client.