Guides

Mises a jour et depannage

Mettez a jour YeePilot, resolvez les problemes courants et gerez votre installation

Dernière mise à jour: 1 mars 2026

Mettre a jour YeePilot

YeePilot inclut un outil de mise a jour integre qui telecharge et installe les nouvelles versions directement depuis la ligne de commande.

Verifier les mises a jour

Voir si une nouvelle version est disponible sans l'installer :

bash

yeepilot update --check

Cela affiche la version actuelle, la derniere version disponible et ce qui a change.

Installer la derniere version

Telecharger et installer la derniere version :

bash

yeepilot update

L'outil de mise a jour va :

Verifier la derniere version disponible.
Telecharger le binaire pour votre plateforme.
Verifier la somme de controle du telechargement.
Remplacer le binaire actuel.

Forcer la reinstallation

Si votre installation est corrompue ou si vous souhaitez reinstaller la meme version :

bash

yeepilot update --force

Cela telecharge et installe la derniere version meme si vous etes deja a jour.

Revenir a la version precedente

Si une nouvelle version introduit un probleme, revenez a la version precedemment installee :

bash

yeepilot update --rollback

YeePilot conserve une sauvegarde du binaire precedent pour rendre les retours en arriere possibles. Le retour en arriere n'est disponible que pour la mise a jour la plus recente -- vous ne pouvez pas revenir en arriere sur plusieurs versions.

Mises a jour automatiques

Par defaut, YeePilot verifie les mises a jour automatiquement toutes les heures et vous notifie lorsqu'une nouvelle version est disponible.

Configuration

yaml

# ~/.yeepilot/config.yaml
update:
  auto_check: true
  check_interval_hours: 1

Desactiver les verifications automatiques de mise a jour

Si vous preferez gerer les mises a jour manuellement :

yaml

update:
  auto_check: false

Ou via variable d'environnement :

bash

export YEEPILOT_UPDATE_AUTO_CHECK=false

Ajuster la frequence de verification

Verifier moins frequemment pour reduire les requetes reseau :

yaml

update:
  check_interval_hours: 24  # Une fois par jour

Depannage des problemes courants

"Connection refused" ou "Connection timed out"

Symptomes : YeePilot ne peut pas joindre l'API du fournisseur IA.

Causes et solutions :

Cle API invalide -- Verifiez que votre cle API est correcte :
bash
```
yeepilot status
```
Si la cle est mauvaise, reconfigurez-la :
bash
```
yeepilot setup --auth
```
Mauvaise URL du fournisseur -- Si vous utilisez une base_url personnalisee, verifiez qu'elle est accessible :
bash
```
curl -I https://api.openai.com/v1/models
```
Problemes reseau -- Verifiez votre connexion internet et les parametres de proxy/pare-feu. Si vous etes derriere un proxy d'entreprise, assurez-vous qu'il autorise le trafic HTTPS vers le point de terminaison API de votre fournisseur IA.
Sandbox bloquant le reseau -- Si sandbox.network_access est defini a false, les commandes executees par YeePilot ne peuvent pas acceder au reseau. Cependant, les appels API propres a YeePilot ne sont pas affectes par les parametres du sandbox. Cette erreur provient plus probablement de la configuration reseau.

"Model not found" ou "Invalid model"

Symptomes : Le fournisseur IA rejette l'identifiant du modele.

Causes et solutions :

Identifiant de modele incorrect -- Les identifiants de modeles sont specifiques au fournisseur. Verifiez que vous utilisez le bon format :

Fournisseur Exemple d'identifiant de modele
OpenAI gpt-4o, gpt-4o-mini
Anthropic claude-sonnet-4-20250514
OpenRouter openai/gpt-4o, anthropic/claude-sonnet-4-20250514
Acces au modele non active -- Certains modeles necessitent une approbation d'acces explicite du fournisseur. Verifiez le tableau de bord de votre fournisseur pour vous assurer que vous avez acces au modele.

Fournisseur	Exemple d'identifiant de modele
OpenAI	`gpt-4o`, `gpt-4o-mini`
Anthropic	`claude-sonnet-4-20250514`
OpenRouter	`openai/gpt-4o`, `anthropic/claude-sonnet-4-20250514`

Incompatibilite de fournisseur -- Assurez-vous que l'identifiant du modele correspond a votre fournisseur configure. Un identifiant de modele Anthropic ne fonctionnera pas avec un parametre de fournisseur OpenAI.

yaml

# Correct : le modele correspond au fournisseur
ai:
  provider: anthropic
  model: claude-sonnet-4-20250514
 
# Incorrect : modele Anthropic avec fournisseur OpenAI
ai:
  provider: openai
  model: claude-sonnet-4-20250514

"Permission denied"

Symptomes : YeePilot ne peut pas executer de commandes ou acceder a des fichiers.

Causes et solutions :

Permissions du binaire -- Le binaire YeePilot a besoin de la permission d'execution :
bash
```
chmod +x /usr/local/bin/yeepilot
```
Emplacement d'installation -- Si l'installation dans /usr/local/bin/ necessite les droits root, utilisez sudo :
bash
```
sudo curl -fsSL https://yee.to/install.sh | bash
```

Chemins interdits du sandbox -- Verifiez si le chemin cible est dans votre liste sandbox.denied_paths :

yaml

sandbox:
  denied_paths:
    - "/etc/shadow"  # Les commandes ne peuvent pas acceder a ce chemin

Propriete des fichiers -- Assurez-vous que le repertoire de configuration appartient a votre utilisateur :
bash
```
ls -la ~/.yeepilot/
# Si possede par root :
sudo chown -R $(whoami) ~/.yeepilot/
```

"Keyring not available" ou erreurs de stockage d'identifiants

Symptomes : YeePilot ne peut pas stocker ou recuperer les cles API depuis le trousseau de cles systeme.

Causes et solutions :

Linux : installer libsecret-tools

bash

# Ubuntu / Debian
sudo apt install libsecret-tools
 
# Fedora / CentOS
sudo dnf install libsecret
 
# Arch
sudo pacman -S libsecret

Serveur Linux sans interface graphique : pas de demon de trousseau -- Sur les serveurs sans environnement de bureau, YeePilot bascule vers un fichier JSON chiffre dans ~/.yeepilot/credentials.json. Si ce basculement ne fonctionne pas, assurez-vous que le repertoire de configuration existe et est accessible en ecriture :
bash
```
mkdir -p ~/.yeepilot
chmod 700 ~/.yeepilot
```
macOS : invite d'Acces au trousseau -- Si les invites du Trousseau apparaissent de maniere repetee, cliquez sur Toujours autoriser pour accorder a YeePilot un acces permanent.
Utiliser les variables d'environnement comme solution de contournement -- Si le stockage d'identifiants continue de poser probleme, definissez votre cle API via variable d'environnement :
bash
```
export OPENAI_API_KEY=sk-...
```

Erreurs de sandbox

Symptomes : Les commandes echouent avec des erreurs liees aux espaces de noms ou au sandbox.

Causes et solutions :

Espaces de noms utilisateur desactives -- Certains noyaux Linux ou configurations durcies desactivent les espaces de noms utilisateur. Verifiez :
bash
```
cat /proc/sys/kernel/unprivileged_userns_clone
```
Si la sortie est 0, soit activez-les :
bash
```
sudo sysctl kernel.unprivileged_userns_clone=1
```
Soit desactivez le sandboxing par espaces de noms :
yaml
```
sandbox:
  use_namespaces: false
```
macOS ou Windows -- Le sandboxing par espaces de noms n'est pas disponible sur ces plateformes. YeePilot le desactive automatiquement, mais si vous voyez des erreurs, definissez explicitement :
yaml
```
sandbox:
  use_namespaces: false
```

Sandbox trop restrictif -- Si des commandes legitimes sont bloquees, ajustez les limites :

yaml

sandbox:
  max_cpu_seconds: 600    # Augmenter de 300
  max_memory_mb: 1024     # Augmenter de 512
  max_processes: 128      # Augmenter de 64

"Token limit exceeded" ou contexte trop volumineux

Symptomes : Le fournisseur IA rejette les requetes car le message est trop long.

Causes et solutions :

Reduire l'historique de conversation -- Moins de messages signifie moins de contexte a envoyer :
yaml
```
ai:
  conversation_max_history: 5
```
Reduire la troncature de sortie -- Limiter la quantite de sortie de commande incluse :
yaml
```
ai:
  output_truncate_length: 200
```
Activer le mode economique de tokens -- Compresse le contexte plus agressivement :
yaml
```
ai:
  token_mode: saver
```
Demarrer une nouvelle session -- Si la session actuelle a accumule trop de contexte, repartez de zero. L'IA ne transfere pas le contexte entre les sessions.

Problemes d'affichage du TUI

Symptomes : Sortie brouillee, caracteres de dessin de boites casses ou couleurs manquantes.

Causes et solutions :

Utiliser un terminal moderne -- Les terminaux anciens peuvent ne pas supporter l'Unicode ou les couleurs vraies. Sous Windows, utilisez Windows Terminal. Sous Linux, utilisez n'importe quel emulateur de terminal moderne (GNOME Terminal, Konsole, Alacritty, Kitty).
Verifier les parametres de locale -- Assurez-vous que votre locale supporte UTF-8 :
bash
```
locale
```
Si LANG ne se termine pas par .UTF-8, definissez-le :
bash
```
export LANG=en_US.UTF-8
```
Changer de theme -- Si les couleurs semblent incorrectes, essayez un theme different :
yaml
```
tui:
  theme: dark  # ou light, neon, auto
```
Desactiver le panneau de diffusion en direct -- Si le panneau en direct cause des scintillements :
yaml
```
tui:
  live_stream_panel_enabled: false
```

Reinitialiser la configuration

Si votre fichier de configuration est corrompu ou si vous souhaitez repartir de zero :

bash

yeepilot setup --reset

Cela regenere ~/.yeepilot/config.yaml avec les valeurs par defaut et vous guide a nouveau dans l'assistant de configuration.

Pour reinitialiser manuellement, supprimez le fichier de configuration et lancez la configuration :

bash

rm ~/.yeepilot/config.yaml
yeepilot setup

Desinstaller YeePilot

Desinstallation complete

Supprimer le binaire, la configuration, les journaux d'audit, le coffre-fort et toutes les donnees stockees :

bash

yeepilot uninstall --all

Conserver la configuration

Supprimer le binaire mais garder vos fichiers de configuration (utile si vous prevoyez de reinstaller) :

bash

yeepilot uninstall --keep-config

Binaire uniquement

Supprimer uniquement le binaire, en laissant tout le reste intact :

bash

yeepilot uninstall --binary-only

Desinstallation manuelle

Si la commande uninstall n'est pas disponible ou si le binaire est manquant :

Linux/macOS :

bash

sudo rm /usr/local/bin/yeepilot
rm -rf ~/.yeepilot

Windows (PowerShell) :

powershell

Remove-Item "C:\Program Files\YeePilot\yeepilot.exe"
Remove-Item -Recurse "$env:USERPROFILE\.yeepilot"

N'oubliez pas de retirer egalement C:\Program Files\YeePilot de votre PATH sous Windows.

Obtenir de l'aide

Si vous rencontrez un probleme non couvert ici :

Verifier la version -- Assurez-vous d'executer la derniere version :
bash
```
yeepilot update
```
Verifier l'etat -- Examinez votre configuration active :
bash
```
yeepilot status
```
Examiner le journal d'audit -- Le journal d'audit peut contenir des details d'erreur :
bash
```
tail -50 ~/.yeepilot/audit.log
```
Visiter le site web -- Consultez yee.to (opens in new tab) pour la derniere documentation et les annonces.

Bonnes pratiques

Guides