feat: publish CodexPi contest snapshot

docs/local-ai-pc-bridge.md

@@ -0,0 +1,85 @@
+# Bridge PC IA local pour CodexPi
+
+Le bridge permet à CodexPi d’utiliser les modèles Ollama installés sur un PC du
+réseau privé. Ollama reste lié à `127.0.0.1:11434` : seul le bridge authentifié
+écoute sur le réseau local. Le jeton généré pendant l’association est enregistré
+dans les espaces privés de CodexPi et du PC ; il ne contient aucun mot de passe
+CodexPi.
+
+## Prérequis sur le PC
+
+- Python 3.11 ou plus récent ;
+- Ollama démarré ;
+- au moins un modèle de conversation installé ;
+- le PC et le Raspberry Pi joignables sur le même LAN ou tailnet privé.
+
+Vérification rapide sous Windows :
+
+```powershell
+ollama list
+py --version
+```
+
+## Association depuis la PWA
+
+1. Ouvrez **Réglages → Comptes IA**.
+2. Dans **Serveur IA local sur PC**, choisissez **Ajouter un PC**.
+3. Téléchargez `codexpi_ai_bridge.py` et le fichier d’association
+   `codexpi-ai.codexpi-ai` dans le même dossier.
+4. Ouvrez PowerShell dans ce dossier puis lancez :
+
+```powershell
+py .\codexpi_ai_bridge.py --pairing .\codexpi-ai.codexpi-ai
+```
+
+Sous macOS ou Linux :
+
+```bash
+python3 ./codexpi_ai_bridge.py --pairing ./codexpi-ai.codexpi-ai
+```
+
+Windows peut demander l’autorisation réseau pour Python. Autorisez uniquement
+les **réseaux privés**. Le port par défaut est `11435`; Ollama lui-même n’est pas
+publié sur le LAN.
+
+Après association, CodexPi détecte les modèles installés. Choisissez le modèle
+par défaut puis utilisez **OpenCode · PC local** lors de la création d’une
+discussion.
+
+## Redémarrage du bridge
+
+L’association est conservée dans `~/.codexpi/ai-bridge.json`. Aux démarrages
+suivants, la commande ne nécessite plus le fichier temporaire :
+
+```powershell
+py .\codexpi_ai_bridge.py
+```
+
+Pour un démarrage automatique, créez un raccourci ou une tâche Windows qui
+exécute cette commande seulement après l’ouverture de session. Ne placez jamais
+le contenu de `~/.codexpi/ai-bridge.json` dans Git ou dans un partage public.
+
+## Adresse ou port particuliers
+
+Si le PC possède plusieurs interfaces réseau :
+
+```powershell
+py .\codexpi_ai_bridge.py --pairing .\codexpi-ai.codexpi-ai `
+  --advertise-address 192.168.1.20 --port 11435
+```
+
+Le bridge refuse d’annoncer une adresse Internet publique. Pour Tailscale,
+indiquez l’adresse privée du PC visible depuis le Pi.
+
+## Dépannage
+
+- **Ollama ne répond pas** : ouvrez Ollama et vérifiez `ollama list`.
+- **Le Pi ne rejoint pas le bridge** : vérifiez le pare-feu privé Windows et le
+  port `11435`, puis utilisez **Tester la connexion** dans CodexPi.
+- **Le modèle ne sait pas utiliser les outils** : choisissez un modèle dont les
+  capacités Ollama contiennent `tools` et prévoyez un contexte suffisant.
+- **Le PC est éteint** : les comptes cloud restent disponibles ; les nouvelles
+  tâches OpenCode locales échoueront proprement jusqu’au retour du bridge.
+
+La révocation dans CodexPi efface sa copie chiffrée du jeton et retire le
+fournisseur OpenCode local. Arrêtez également le terminal du bridge sur le PC.