HSBG AI — Assistant IA Temps Réel pour Hearthstone Battlegrounds
Assistant IA hybride pour Hearthstone Battlegrounds : capture d'écran automatique, OCR en temps réel, moteur de décision combinant heuristiques et LLM local (Ollama), interface React moderne.
Problématique
Analyser en temps réel l'état d'une partie de jeu complexe et fournir des conseils stratégiques pertinents, sans accès à l'API du jeu, uniquement par analyse visuelle de l'écran.
Solution apportée
Pipeline vision → OCR → analyse d'état → moteur de décision hybride (heuristiques + LLM local) → interface WebSocket temps réel. Chaque couche est découplée et indépendante.
Description du projet
Projet personnel ambitieux combinant vision par ordinateur, intelligence artificielle et développement full-stack pour assister un joueur de Hearthstone Battlegrounds en temps réel.
Le système capture automatiquement l'état du jeu via des screenshots ciblés (librairie mss) de zones spécifiques de l'écran (or disponible, tier de taverne, HP du héros, serviteurs). Un moteur OCR (Tesseract + Pillow) extrait le texte et reconstruit un GameState structuré.
Le moteur de décision fonctionne en mode hybride : un HeuristicEngine basé sur des règles métier codées (tripler des serviteurs, gestion de l'or, positionnement) fournit des décisions rapides et déterministes, tandis qu'un LLMAdvisor utilise un modèle local Ollama (qwen2.5-coder) pour des conseils contextuels enrichis. Les deux sorties sont fusionnées en un FullAdvice priorisé.
L'architecture backend FastAPI gère plusieurs routes (game state, advice, learning, websocket) et un système de feedback permet à l'IA d'apprendre des parties. Le frontend React/Vite/Tailwind CSS affiche les conseils en temps réel via WebSocket.
Résultat
Assistant fonctionnel capable d'analyser l'état du jeu en moins d'une seconde, de proposer des décisions priorisées avec justification, et d'apprendre des retours utilisateur.