# 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.