Repository navigation
v4.0.0
Première version publiée depuis la 3.5.8. Elle réunit le travail des versions 3.5.9 à 3.8.0, restées sur la branche de développement.
IAnalyze prépare l'analyse d'une partie d'échecs par un LLM : il rassemble le PGN, les statistiques de l'explorateur Lichess, le catalogue des ouvertures et les évaluations de Stockfish. Il ne produit lui-même aucune analyse.
Nouveautés
- Le prompt d'analyse est écrit à côté de l'archive. Il est tiré d'un modèle,
prompt-modele.txt, que vous pouvez modifier sans toucher au script, et ne garde que ce qui s'applique à la partie. --prompt-seulécrit un prompt court, à coller seul dans la conversation, sans pièce jointe : la partie, quelques consignes, et les évaluations de Stockfish. C'est la route à prendre avec un compte gratuit.verifier-analyse.pycontrôle le PGN annoté rendu par le LLM : coups légaux, ligne principale, erreurs et gaffes commentées, évaluations citées, variantes.- La synthèse signale un résultat contraire à l'évaluation finale, une partie notée gagnée dans une position perdue par exemple.
test-app.shjoue toute la suite de tests et écrit un rapport, avectest.pgnpour partie d'essai.
Corrections
- Un mat se compte maintenant après le coup joué : le camp qui mate affichait un coup de trop.
- Une partie notée en français, en figurines ou en minuscules était analysée de travers sans message : elle est refusée, avec sa cause.
- Un PGN à plusieurs parties, ou qui ne part pas de la position initiale, est refusé.
- Un coup nul,
--, ne fausse plus ni la table de l'explorateur ni le tableau du moteur. - Plusieurs entrées mal formées finissaient en "Erreur inattendue" : elles donnent un message.
Quel LLM
Prenez Claude. Avec le zip et le prompt, c'est le seul qui ait rendu un PGN utilisable tel quel dans nos essais. Avec --prompt-seul, compte gratuit compris, c'est lui qui a rendu les PGN les plus propres et les explications les plus justes.
Dans tous les cas : fiez-vous aux chiffres, vérifiez les récits sur l'échiquier. Le détail des essais est dans le README, section 7.
Installation
Python 3.10 ou plus récent, Stockfish, et python-chess dans un environnement virtuel que le script installe lui-même :
./ianalyze.py --installer-venv./ianalyze.py --installer-catalogueLe README donne la marche complète, jeton Lichess compris.
Documentation
README.md: installation et usage courantEXEMPLES.md: toutes les commandes, toutes les options, et ce que le terminal afficheTECHNIQUE.md: le fonctionnement du scriptTESTS.md: les tests, un par unCHANGELOG.md: la liste complète des changements