Configuration

Reference de configuration

Reference complete de toutes les options de configuration de YeePilot dans config.yaml

Dernière mise à jour: 1 mars 2026

Fichier de configuration

YeePilot stocke sa configuration dans ~/.yeepilot/config.yaml. Ce fichier est cree automatiquement lors de la configuration initiale et peut etre modifie manuellement ou via la commande yeepilot setup.

yaml

# Exemple de configuration minimale
ai:
  provider: openai
  model: gpt-4o
 
security:
  mode: strict
 
personality:
  language: en

Pour regenerer votre configuration avec les valeurs par defaut, executez :

bash

yeepilot setup --reset

Parametres IA

La section ai: controle quel fournisseur et modele IA YeePilot utilise et comment il interagit avec le modele de langage.

yaml

ai:
  provider: openai
  model: gpt-4o
  api_key: ""
  base_url: ""
  max_tokens: 4096
  token_mode: normal
  conversation_max_history: 10
  output_truncate_length: 500
  max_response_length: 102400
  engine: v2
  autonomy_profile: guarded
  think_mode: "off"
  agent_mode: false

provider

Le backend IA a utiliser. Valeurs supportees : openai, anthropic, openrouter.

yaml

ai:
  provider: openai

model

L'identifiant specifique du modele. Doit etre un identifiant de modele valide pour le fournisseur choisi.

Fournisseur	Exemples de modeles
openai	`gpt-4o`, `gpt-4o-mini`, `o3-mini`
anthropic	`claude-sonnet-4-20250514`, `claude-haiku-4-20250414`
openrouter	`openai/gpt-4o`, `anthropic/claude-sonnet-4-20250514`

api_key

Votre cle API pour le fournisseur configure. Bien que vous puissiez la definir ici, l'utilisation du trousseau de cles du systeme d'exploitation via yeepilot setup --auth ou les variables d'environnement est recommandee pour une meilleure securite.

yaml

ai:
  api_key: "sk-..."

base_url

Remplacer le point de terminaison API par defaut. Utile pour les proxies, les modeles locaux ou les services alternatifs compatibles API.

yaml

ai:
  provider: openai
  base_url: "http://localhost:11434/v1"

max_tokens

Nombre maximum de tokens que l'IA peut generer par reponse. Par defaut : 4096.

yaml

ai:
  max_tokens: 8192

token_mode

Controle la maniere dont YeePilot gere l'utilisation des tokens. Par defaut : normal.

normal -- Contexte complet et reponses detaillees.
saver -- Prompts systeme plus courts, historique compresse, compaction de contexte plus agressive. Reduit significativement les couts.

yaml

ai:
  token_mode: saver

conversation_max_history

Nombre de messages precedents a conserver dans le contexte de conversation. Par defaut : 10. Des valeurs plus basses reduisent l'utilisation des tokens et gardent l'IA concentree sur les taches recentes.

yaml

ai:
  conversation_max_history: 10

output_truncate_length

Nombre maximum de caracteres de la sortie de commande a inclure dans le contexte IA. Par defaut : 500. Empeche les sorties volumineuses de consommer votre budget de tokens.

yaml

ai:
  output_truncate_length: 500

max_response_length

Limite stricte de la taille de reponse de l'IA en octets. Par defaut : 102400 (100 Ko).

yaml

ai:
  max_response_length: 102400

engine

La version du moteur d'execution. Par defaut : v2.

v2 -- Moteur actuel avec boucle d'agent, appel d'outils et execution multi-etapes.
legacy -- Generation de commandes en un seul tour sans appel d'outils.

yaml

ai:
  engine: v2

autonomy_profile

Controle le degre de liberte de l'IA pour executer des commandes sans demander de confirmation. Par defaut : guarded.

high -- Execute automatiquement les commandes SAFE et MODERATE. Seules les commandes DANGEROUS necessitent une confirmation.
guarded -- Execute automatiquement les commandes SAFE. Les commandes MODERATE et DANGEROUS necessitent une confirmation.
strict_review -- Chaque commande necessite une confirmation explicite avant execution, quel que soit le niveau de risque.

yaml

ai:
  autonomy_profile: guarded

think_mode

Active le raisonnement etendu pour les fournisseurs qui le supportent (Anthropic, modeles de raisonnement OpenAI). Par defaut : off.

off -- Pas de reflexion etendue.
on -- Activer la reflexion avec le budget par defaut du fournisseur.
low -- Budget de reflexion minimal.
medium -- Budget de reflexion modere pour les taches complexes.
high -- Budget de reflexion maximum pour les problemes les plus difficiles.

yaml

ai:
  think_mode: medium

Vous pouvez egalement basculer cela pendant une session avec la commande slash /think.

agent_mode

Active la boucle d'agent IA, permettant a l'IA d'enchainer plusieurs appels d'outils et commandes pour accomplir des taches complexes. Par defaut : false.

yaml

ai:
  agent_mode: true

Parametres de securite

La section security: controle les verifications de securite des commandes, les exigences de confirmation et la journalisation d'audit.

yaml

security:
  mode: strict
  require_confirmation: true
  blocked_patterns:
    - "rm -rf /"
    - "mkfs"
    - "dd if=/dev/zero"
  audit_log_path: "~/.yeepilot/audit.log"
  audit_max_size_mb: 10
  audit_max_archives: 50

mode

La posture de securite globale. Par defaut : strict.

strict -- Securite maximale. Les commandes les plus destructrices sont entierement bloquees. Recommande pour les serveurs de production.
moderate -- Securite equilibree. Les commandes destructrices necessitent une confirmation mais ne sont pas bloquees.
permissive -- Restrictions minimales. Seules les commandes les plus dangereuses (ex. effacement de disques) sont bloquees. Convient uniquement aux environnements de developpement isoles.

yaml

security:
  mode: strict

require_confirmation

Si une invite doit etre affichee avant d'executer les commandes. Par defaut : true. Lorsque defini a false, le profil d'autonomie determine quelles commandes s'executent automatiquement.

yaml

security:
  require_confirmation: true

blocked_patterns

Motifs de commandes supplementaires a bloquer entierement. Ceux-ci sont ajoutes par-dessus la liste de blocage integree de YeePilot de plus de 70 motifs dangereux.

yaml

security:
  blocked_patterns:
    - "shutdown"
    - "reboot"
    - "halt"
    - "init 0"

audit_log_path

Chemin du fichier pour le journal d'audit inviolable. Par defaut : ~/.yeepilot/audit.log.

yaml

security:
  audit_log_path: "/var/log/yeepilot/audit.log"

audit_max_size_mb

Taille maximale d'un fichier de journal d'audit unique avant rotation. Par defaut : 10 Mo.

yaml

security:
  audit_max_size_mb: 10

audit_max_archives

Nombre de fichiers de journal d'audit rotatifs a conserver. Par defaut : 50.

yaml

security:
  audit_max_archives: 50

Parametres du sandbox

La section sandbox: configure l'isolation d'execution des commandes. Les parametres du sandbox limitent ce que les commandes peuvent faire pour proteger votre systeme.

yaml

sandbox:
  enabled: true
  use_namespaces: true
  network_access: true
  max_cpu_seconds: 300
  max_memory_mb: 512
  max_filesize_mb: 100
  max_processes: 64
  denied_paths:
    - "/etc/shadow"
    - "/root/.ssh"

enabled

Activer ou desactiver le sandbox d'execution. Par defaut : true. Desactiver supprime toutes les limites d'execution.

yaml

sandbox:
  enabled: true

use_namespaces

Utiliser les espaces de noms du noyau Linux pour une isolation complete des processus (utilisateur, PID, montage, reseau). Par defaut : true. Disponible uniquement sous Linux. Revient aux limites au niveau du processus sous macOS et Windows.

yaml

sandbox:
  use_namespaces: true

network_access

Autoriser les commandes a acceder au reseau. Par defaut : true. Definissez a false pour isoler completement l'execution des commandes du reseau.

yaml

sandbox:
  network_access: false

max_cpu_seconds

Temps CPU maximum qu'une seule commande peut consommer. Par defaut : 300 secondes (5 minutes).

yaml

sandbox:
  max_cpu_seconds: 300

max_memory_mb

Memoire maximale qu'une commande peut utiliser. Par defaut : 512 Mo.

yaml

sandbox:
  max_memory_mb: 512

max_filesize_mb

Taille maximale de tout fichier qu'une commande peut creer. Par defaut : 100 Mo.

yaml

sandbox:
  max_filesize_mb: 100

max_processes

Nombre maximum de processus enfants qu'une commande peut engendrer. Par defaut : 64.

yaml

sandbox:
  max_processes: 64

denied_paths

Chemins de fichiers auxquels les commandes n'ont pas le droit de lire ou ecrire. Ajoutes par-dessus les chemins proteges integres.

yaml

sandbox:
  denied_paths:
    - "/etc/shadow"
    - "/etc/passwd"
    - "/root/.ssh"
    - "/home/*/.ssh/id_*"

Parametres de personnalite

La section personality: controle la maniere dont YeePilot communique avec vous.

yaml

personality:
  tone: casual
  language: en
  use_emoji: true
  verbosity: normal

tone

Le ton conversationnel des reponses de l'IA. Par defaut : casual.

casual -- Reponses amicales et conversationnelles.
professional -- Reponses formelles et concises. Adapte aux environnements professionnels.
minimal -- Explications au strict minimum. Juste les commandes et les resultats.

yaml

personality:
  tone: professional

language

Langue de l'interface et des reponses IA de YeePilot. Par defaut : en.

en -- Anglais
de -- Allemand (Deutsch)
auto -- Detection depuis la locale systeme

yaml

personality:
  language: auto

use_emoji

Inclure des emoji dans les reponses IA et les messages d'etat. Par defaut : true.

yaml

personality:
  use_emoji: false

verbosity

Niveau de detail que l'IA inclut dans ses reponses. Par defaut : normal.

brief -- Explications courtes et directes.
normal -- Explications equilibrees avec du contexte.
detailed -- Explications approfondies avec des informations de fond.

yaml

personality:
  verbosity: detailed

Parametres TUI

La section tui: personnalise l'apparence et le comportement de l'interface utilisateur du terminal.

yaml

tui:
  theme: auto
  stats_panel: true
  code_line_numbers: true
  live_stream_panel_enabled: true
  live_stream_panel_height: 12

theme

Theme de couleurs pour l'interface terminal. Par defaut : auto (correspond au fond du terminal).

Themes disponibles : auto, dark, light, neon et plus.

yaml

tui:
  theme: neon

stats_panel

Afficher le panneau de statistiques avec l'utilisation des tokens, les couts et les informations de session. Par defaut : true.

yaml

tui:
  stats_panel: true

code_line_numbers

Afficher les numeros de ligne dans les blocs de code affiches dans le TUI. Par defaut : true.

yaml

tui:
  code_line_numbers: true

live_stream_panel_enabled

Afficher un panneau en direct qui diffuse la sortie des commandes en temps reel pendant leur execution. Par defaut : true.

yaml

tui:
  live_stream_panel_enabled: true

live_stream_panel_height

Nombre de lignes pour le panneau de diffusion en direct. Par defaut : 12.

yaml

tui:
  live_stream_panel_height: 16

Parametres du coffre-fort

La section vault: configure le coffre-fort d'identifiants chiffre pour stocker les secrets comme les mots de passe de base de donnees et les tokens d'API.

yaml

vault:
  enabled: true
  start_locked: true
  auto_lock_duration: "15m"
  bruteforce_protection_enabled: true

enabled

Activer la fonctionnalite de coffre-fort chiffre. Par defaut : true.

yaml

vault:
  enabled: true

start_locked

Si le coffre-fort doit etre verrouille au demarrage de YeePilot, necessitant son deverrouillage. Par defaut : true.

yaml

vault:
  start_locked: true

auto_lock_duration

Verrouiller automatiquement le coffre-fort apres cette duree d'inactivite. Par defaut : 15m. Supporte le format de duree Go (ex. 5m, 1h, 30s).

yaml

vault:
  auto_lock_duration: "30m"

bruteforce_protection_enabled

Activer la protection contre la force brute qui ralentit les tentatives de deverrouillage apres des echecs repetes. Par defaut : true.

yaml

vault:
  bruteforce_protection_enabled: true

Parametres de plateforme

La section platform: configure la connectivite au service de plateforme YeePilot.

yaml

platform:
  server_url: "https://yee.to"

server_url

L'URL du serveur de plateforme YeePilot. Par defaut : https://yee.to. Ne modifiez cela que si vous utilisez une instance de plateforme auto-hebergee.

yaml

platform:
  server_url: "https://yee.to"

Parametres de mise a jour

La section update: controle le comportement de mise a jour automatique.

yaml

update:
  auto_check: true
  check_interval_hours: 1

auto_check

Verifier automatiquement les mises a jour au demarrage de YeePilot. Par defaut : true.

yaml

update:
  auto_check: true

check_interval_hours

Frequence de verification des mises a jour, en heures. Par defaut : 1.

yaml

update:
  check_interval_hours: 24

Parametres des fichiers

La section files: controle le comportement de la commande /file pour le chargement de fichiers comme contexte IA.

yaml

files:
  max_entries: 20
  max_file_size: 102400
  max_total: 524288
  upload_dir: ""

max_entries

Nombre maximum de fichiers pouvant etre attaches a une session. Par defaut : 20.

yaml

files:
  max_entries: 20

max_file_size

Taille maximale d'un fichier unique en octets. Par defaut : 102400 (100 Ko).

yaml

files:
  max_file_size: 102400

max_total

Taille totale maximale de tous les fichiers attaches en octets. Par defaut : 524288 (512 Ko).

yaml

files:
  max_total: 524288

upload_dir

Repertoire personnalise pour les televersements temporaires de fichiers. Laissez vide pour utiliser la valeur par defaut du systeme.

yaml

files:
  upload_dir: "/tmp/yeepilot-files"

Exemple de configuration complete

Voici un fichier de configuration complet avec toutes les sections et les valeurs couramment ajustees :

yaml

ai:
  provider: openai
  model: gpt-4o
  max_tokens: 4096
  token_mode: normal
  conversation_max_history: 10
  output_truncate_length: 500
  max_response_length: 102400
  engine: v2
  autonomy_profile: guarded
  think_mode: "off"
  agent_mode: false
 
security:
  mode: strict
  require_confirmation: true
  blocked_patterns: []
  audit_log_path: "~/.yeepilot/audit.log"
  audit_max_size_mb: 10
  audit_max_archives: 50
 
sandbox:
  enabled: true
  use_namespaces: true
  network_access: true
  max_cpu_seconds: 300
  max_memory_mb: 512
  max_filesize_mb: 100
  max_processes: 64
  denied_paths: []
 
personality:
  tone: casual
  language: en
  use_emoji: true
  verbosity: normal
 
tui:
  theme: auto
  stats_panel: true
  code_line_numbers: true
  live_stream_panel_enabled: true
  live_stream_panel_height: 12
 
vault:
  enabled: true
  start_locked: true
  auto_lock_duration: "15m"
  bruteforce_protection_enabled: true
 
platform:
  server_url: "https://yee.to"
 
update:
  auto_check: true
  check_interval_hours: 1
 
files:
  max_entries: 20
  max_file_size: 102400
  max_total: 524288

Coffre-fort d'identifiants

Security

Variables d'environnement

Configuration