Skip to content

v4.0.0

Choose a tag to compare

@deuza deuza released this 21 Nov 15:22
· 16 commits to main since this release
v4.0.0
6e0410d

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.py contrô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.sh joue toute la suite de tests et écrit un rapport, avec test.pgn pour 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-catalogue

Le README donne la marche complète, jeton Lichess compris.

Documentation

  • README.md : installation et usage courant
  • EXEMPLES.md : toutes les commandes, toutes les options, et ce que le terminal affiche
  • TECHNIQUE.md : le fonctionnement du script
  • TESTS.md : les tests, un par un
  • CHANGELOG.md : la liste complète des changements