86 lines
3.0 KiB
Markdown
86 lines
3.0 KiB
Markdown
# 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.
|