chesspreview/README.md

Atelier 64

Studio personnel d’échecs: jouez librement les deux couleurs, recevez trois propositions Stockfish après chaque coup, puis demandez une explication en français à un serveur Ollama distant.

Démarrage Docker

docker compose up --build

Ouvrir http://localhost:8080. Stockfish est inclus dans l’image Docker.

Dans Réglages, saisir adresse Ollama et modèle. Avec Ollama sur même ordinateur que Docker Desktop:

http://host.docker.internal:11434

Ollama doit écouter sur réseau accessible au conteneur. Exemple côté machine Ollama:

OLLAMA_HOST=0.0.0.0:11434 ollama serve
ollama pull qwen3:8b

Modèles conseillés

• qwen3:8b: choix par défaut, rapide, bon français, environ 6 Go disponibles.
• qwen3:30b: explications supérieures, machine distante puissante, environ 24 Go disponibles.
• Stockfish choisit toujours les coups. Ollama explique seulement les variantes calculées: qualité échiquéenne reste stable quel que soit LLM.

Développement

Pré-requis: Node.js 22 et Stockfish installé dans le PATH.

npm install
npm run dev

Interface: http://localhost:5173. API: http://localhost:3000.

Fonctions

• jeu des deux côtés par clic ou glisser-déposer;
• coups légaux signalés, promotion automatique en dame;
• meilleure flèche activable, 3 variantes, évaluation et profondeur réglable;
• annulation, rotation, nouvelle partie, feuille de partie;
• détection échec, mat et nulle;
• Ollama distant configurable et testable depuis interface;
• réglages conservés localement dans navigateur;
• mise en page responsive et commandes accessibles au clavier.