Build Atelier 64 chess training app

README.md

@@ -0,0 +1,52 @@
+# 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
+
+```bash
+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:
+
+```text
+http://host.docker.internal:11434
+```
+
+Ollama doit écouter sur réseau accessible au conteneur. Exemple côté machine Ollama:
+
+```bash
+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.
+
+```bash
+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.