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