Un script qui analyse vos parties sur chess.com en temps réel grâce à Stockfish, affiche les meilleurs coups avec des flèches, et peut jouer automatiquement à votre place (mode auto-play).
- Un navigateur : Brave, Chrome ou Firefox
- Tampermonkey : une extension navigateur
- Python 3.7+ : un langage de programmation
- Stockfish : le moteur d'échecs
- Ce script : les fichiers de ce repo
Tampermonkey est une extension qui permet d'exécuter des scripts dans votre navigateur.
-
Ouvrez votre navigateur
-
Allez sur le store de votre navigateur :
- Chrome / Brave → chrome.google.com/webstore → recherchez "Tampermonkey"
- Firefox → addons.mozilla.org → recherchez "Tampermonkey"
-
Cliquez "Ajouter" ou "Installer"
-
Allez dans vos extensions navigateur et épinglez Tempermonkey
-
Une icône Tampermonkey apparaît en haut à droite de votre navigateur ✅
Il se peut que Tempermonkey ne s'active pas immédiatement, si c'est le cas cliquez sur le petit bandeau bleu qui s'affichera en haut de la page "tableau de bord" de Tempermonkey et suivez les instructions qui s'afficheront pour l'activer.
Python est nécessaire pour faire tourner le serveur local qui communique avec Stockfish.
- Allez sur python.org/downloads
- Cliquez sur le gros bouton "Download Python"
- Lancez l'installateur téléchargé
⚠️ IMPORTANT : cochez la case "Add Python to PATH" avant de cliquer Install- Cliquez "Install Now"
- Une fois terminé, Python est installé ✅
Stockfish est le moteur d'échecs qui calcule les meilleurs coups.
- Allez sur stockfishchess.org/download
- Cliquez sur Windows
- Téléchargez le fichier
.zip - Extrayez le
.zip— vous obtenez un fichier.exe - Copiez ce fichier
.exedans le dossierchess-server(le dossier de ce projet) ✅
- Sur cette page GitHub, cliquez sur le bouton vert "Code"
- Cliquez "Download ZIP"
- Extrayez le ZIP où vous voulez (ex : sur le Bureau)
- Vous obtenez un dossier
chess-serveravec tous les fichiers ✅
- Cliquez sur l'icône Tampermonkey en haut à droite de votre navigateur
- Cliquez "Tableau de bord"
- Cliquez l'onglet "Utilitaires"
- Dans la section "Importer depuis un fichier", cliquez "Choisir un fichier"
- Sélectionnez le fichier
chess-coach-v9_5_user.jsdu dossier téléchargé - Cliquez "Installer" ✅
Le serveur local fait le lien entre votre navigateur et Stockfish.
-
Ouvrez le dossier
chess-server -
Double-cliquez sur
lancer.shSi ça ne marche pas, ouvrez PowerShell dans le dossier (cliquez sur la barre d'adresse de l'Explorateur Windows, tapez
powershell, appuyez sur Entrée) et tapez :python server.py -
Une fenêtre noire s'ouvre avec le message
♟ Serveur lancé → http://localhost:8765✅ -
Laissez cette fenêtre ouverte pendant toute votre session de jeu
- Lancez le serveur (Étape 6)
- Allez sur chess.com et commencez une partie contre un bot
- Le panneau Chess Coach apparaît en bas à droite de l'écran
- Cliquez "▶ Coach ON" pour activer l'analyse
- Une flèche verte indique le meilleur coup à jouer
- (Optionnel) Cliquez "🤖 Auto-play ON" pour que le script joue automatiquement
Coach ON/OFF — Active ou désactive l'analyse en temps réel.
Auto-play ON/OFF — Le script joue les coups automatiquement à votre place.
Niveau Stockfish — De 1 (analyse rapide et superficielle) à 20 (niveau grand maître, calcul long).
Barre d'évaluation — Affiche qui est en avantage dans la partie. Plus la barre est blanche, mieux c'est pour les blancs. Plus elle est noire, mieux c'est pour les noirs.
serveur allumé : serveur éteint :
Le panneau Chess Coach n'apparaît pas
Vérifiez que Tampermonkey est bien activé (cliquez sur l'icône en haut à droite du navigateur et vérifiez que le script est bien "Activé"). Rechargez ensuite la page chess.com.
Le point reste rouge (serveur déconnecté)
Le serveur Python n'est pas lancé. Retournez à l'Étape 6. Le point devient vert quand le serveur tourne correctement.
La promotion de pion ne se fait pas automatiquement
Assurez-vous d'utiliser la version v9.5 du script (le fichier chess-coach-v9_5_user.js).
Stockfish introuvable au démarrage
Vérifiez que le fichier .exe de Stockfish est bien copié dans le dossier chess-server. Le nom du fichier doit commencer par stockfish.
Ce script est conçu pour s'entraîner contre des bots sur chess.com. L'utiliser en partie classée contre de vrais joueurs est contraire aux conditions d'utilisation de chess.com. l'utilisation de ce script contre des joueurs peut entreîner le banissement définitif de votre comte chess.com
server.py— Serveur local Pythonchess.html— Interface web optionnellelancer.sh— Script de démarrage rapidechess-coach-v9_5_user.js— Script Tampermonkey à installerREADME.md— Ce fichier d'instructionsstockfish.exe— À télécharger séparément sur stockfishchess.org (trop lourd pour GitHub)
Lorsque le serveur est connecté, ce script atteint un niveau d'environ 3600 elo et une profondeur maximum de 40, soit 20 coups complets et 40 demi-coups. La profondeur de stockfish dépendra principalement de la puissance de votre processeur. Stockfish a une précision globale de 99. Si le serveur n'est pas connecté, ce sera stockfish WASM qui tournera en local sur votre PC qui calculera les coups. Stockfish WASM a un niveau elo d'environ 2200 elo et une profondeur maximum de 17 demi-coups. Il est bien plus lent que stockfish natal pour calculer les coups. SI vous augmentez le niveau de stockfish au dessus de 10, le temps imparti pour chaque coups qu'utilise le script et qui est de 12 secondes augmentera.
Le niveau Stockfish influence directement le temps de calcul entre chaque coup. Voici quelques repères :
Niveau 1 à 5 — calcul quasi instantané, idéal si vous avez peut de temps (blitz) mais moins bonne qualité de coup
Niveau 6 à 10 — quelques secondes de calcul, bon compromis entre vitesse et qualité
Niveau 11 à 15 — calcul plus long (5 à 10 secondes), recommandé des temps plus long
Niveau 16 à 19 — calcul lent, réservé aux parties avec beaucoup de temps ou sans limite de temps
Niveau 20 — profondeur maximale (40 demi-coups), peut prendre jusqu'à 30 secondes selon votre processeur, à utiliser uniquement contre les bots les plus forts sans limite de temps
En mode auto-play, le script attend automatiquement la fin du calcul avant de jouer. Plus votre processeur est puissant, plus les niveaux élevés seront rapides.
Ce script calcule également la précision en temps réel de votre adversaire et vous.
Le mode humain simule un joueur humain fort qui fait de petites erreurs naturelles, au lieu de jouer parfaitement à chaque coup. Comment ça fonctionne : Quand le mode humain est activé avec l'auto-play, Stockfish analyse les 3 meilleurs coups disponibles à chaque position au lieu du seul meilleur. Ensuite, à chaque coup, un tirage aléatoire détermine lequel jouer :
70% du temps → le meilleur coup est joué normalement 30% du temps → le 2e ou 3e meilleur coup est joué à la place
Le 2e et 3e meilleur coup sont toujours des coups raisonnables — pas des blunders catastrophiques, juste des petites imprécisions qui font perdre quelques centipawns, comme un humain fort le ferait naturellement. Le délai de jeu est aussi rendu plus réaliste : entre 1.5 et 6 secondes par coup, avec 20% de chance de "réfléchir longtemps" (4 à 9 secondes), simulant les moments d'hésitation humaine. Impact sur la précision : avec le mode humain actif, votre précision affichée sera autour de 85-92% au lieu de 100%, ce qui est cohérent avec un niveau Grand Maître humain. Note : le mode humain nécessite le serveur local Stockfish pour fonctionner (point vert dans le panneau). Il n'est pas compatible avec le moteur WASM de secours.
🔄 Rejouer Automatiquement La case à cocher "Rejouer automatiquement" dans le panneau permet d'enchaîner les parties sans intervention manuelle. Comment ça fonctionne : Une fois cochée, le script surveille en permanence la fin de partie. Dès qu'un bouton "Rejouer", "Revanche" ou "Nouvelle partie" apparaît à l'écran, il attend 3 secondes puis clique automatiquement dessus pour lancer une nouvelle partie. Le délai de 3 secondes est intentionnel — il laisse le temps de décocher l'option si vous souhaitez arrêter avant que la prochaine partie commence. Important : cette option fonctionne indépendamment du coach et de l'auto-play. Elle détecte le bouton même si le coach est désactivé.