Variables d'environnement

Apercu

Chaque option de configuration de YeePilot peut etre remplacee a l'aide de variables d'environnement. C'est utile pour les pipelines CI/CD, les deploiements conteneurises, les remplacements temporaires et pour garder les secrets hors des fichiers de configuration.

Les variables d'environnement ont toujours la priorite sur les valeurs dans ~/.yeepilot/config.yaml.

Convention de nommage

Les variables d'environnement suivent un schema coherent :

1. Commencez par le prefixe YEEPILOT_.
2. Convertissez la cle de configuration en MAJUSCULES.
3. Remplacez les points et les cles imbriquees par des underscores.

Exemples

Priorite de configuration

Lorsque le meme parametre est defini a plusieurs endroits, YeePilot les resout dans cet ordre (priorite la plus haute en premier) :

1. Variables d'environnement -- Toujours prioritaires.
2. Fichier de configuration (~/.yeepilot/config.yaml) -- Utilise si aucune variable d'environnement n'est definie.
3. Valeurs par defaut integrees -- Utilisees si ni la variable d'environnement ni la valeur du fichier de configuration n'existent.

# Ceci remplace ce qui est dans config.yaml
export YEEPILOT_AI_PROVIDER=anthropic
export YEEPILOT_AI_MODEL=claude-sonnet-4-20250514
 
yeepilot run

Variables d'environnement courantes

Parametres du fournisseur IA

# Selectionner le fournisseur et le modele
export YEEPILOT_AI_PROVIDER=openai
export YEEPILOT_AI_MODEL=gpt-4o
 
# Cle API (preferee au fichier de configuration pour la securite)
export YEEPILOT_AI_API_KEY=sk-...
 
# Point de terminaison API personnalise (ex. pour les modeles locaux)
export YEEPILOT_AI_BASE_URL=http://localhost:11434/v1
 
# Gestion des tokens
export YEEPILOT_AI_MAX_TOKENS=8192
export YEEPILOT_AI_TOKEN_MODE=saver
 
# Agent et reflexion
export YEEPILOT_AI_AGENT_MODE=true
export YEEPILOT_AI_THINK_MODE=medium
export YEEPILOT_AI_AUTONOMY_PROFILE=strict_review

Parametres de securite

# Posture de securite
export YEEPILOT_SECURITY_MODE=strict
export YEEPILOT_SECURITY_REQUIRE_CONFIRMATION=true
 
# Emplacement du journal d'audit
export YEEPILOT_SECURITY_AUDIT_LOG_PATH=/var/log/yeepilot/audit.log

Parametres du sandbox

# Desactiver les espaces de noms (utile sous macOS ou dans les environnements restreints)
export YEEPILOT_SANDBOX_USE_NAMESPACES=false
 
# Ajuster les limites de ressources
export YEEPILOT_SANDBOX_MAX_CPU_SECONDS=600
export YEEPILOT_SANDBOX_MAX_MEMORY_MB=1024

Personnalite et affichage

# Langue et ton
export YEEPILOT_PERSONALITY_LANGUAGE=de
export YEEPILOT_PERSONALITY_TONE=professional
export YEEPILOT_PERSONALITY_VERBOSITY=brief
 
# Theme TUI
export YEEPILOT_TUI_THEME=dark

Variables de cle API directes

En plus de YEEPILOT_AI_API_KEY, YeePilot reconnait egalement les variables de cle API standard utilisees par chaque fournisseur :

Celles-ci fonctionnent sans le prefixe YEEPILOT_ et sont verifiees automatiquement lorsqu'aucune autre cle API n'est configuree.

# Ceux-ci sont equivalents pour OpenAI :
export YEEPILOT_AI_API_KEY=sk-abc123
# ou
export OPENAI_API_KEY=sk-abc123

Si YEEPILOT_AI_API_KEY et une variable specifique au fournisseur sont toutes les deux definies, YEEPILOT_AI_API_KEY est prioritaire.

Exemples pratiques

Changement temporaire de fournisseur

Basculer vers un fournisseur different pour une seule session sans modifier votre fichier de configuration :

YEEPILOT_AI_PROVIDER=anthropic \
YEEPILOT_AI_MODEL=claude-sonnet-4-20250514 \
ANTHROPIC_API_KEY=sk-ant-... \
yeepilot run

Verrouillage de serveur de production

Definir une securite stricte via l'environnement pour tous les utilisateurs sur un serveur partage :

# Ajouter a /etc/environment ou /etc/profile.d/yeepilot.sh
export YEEPILOT_SECURITY_MODE=strict
export YEEPILOT_AI_AUTONOMY_PROFILE=strict_review
export YEEPILOT_SANDBOX_ENABLED=true
export YEEPILOT_SANDBOX_USE_NAMESPACES=true
export YEEPILOT_SANDBOX_NETWORK_ACCESS=false

Pipeline CI/CD

Utiliser YeePilot dans un pipeline non interactif :

export YEEPILOT_AI_PROVIDER=openai
export YEEPILOT_AI_MODEL=gpt-4o-mini
export OPENAI_API_KEY="${OPENAI_SECRET}"
export YEEPILOT_SECURITY_MODE=strict
export YEEPILOT_AI_AUTONOMY_PROFILE=high
 
yeepilot exec "verifier l'utilisation disque et signaler les serveurs au-dessus de 80%"

Configuration economique

Minimiser l'utilisation des tokens et les couts d'API :

export YEEPILOT_AI_TOKEN_MODE=saver
export YEEPILOT_AI_MAX_TOKENS=2048
export YEEPILOT_AI_CONVERSATION_MAX_HISTORY=5
export YEEPILOT_AI_OUTPUT_TRUNCATE_LENGTH=200

Configuration du shell

Pour rendre les variables d'environnement persistantes entre les sessions, ajoutez-les a votre profil de shell :

Bash

# Ajouter a ~/.bashrc ou ~/.bash_profile
export YEEPILOT_AI_PROVIDER=openai
export OPENAI_API_KEY=sk-...

Zsh

# Ajouter a ~/.zshrc
export YEEPILOT_AI_PROVIDER=openai
export OPENAI_API_KEY=sk-...

Fish

# Ajouter a ~/.config/fish/config.fish
set -gx YEEPILOT_AI_PROVIDER openai
set -gx OPENAI_API_KEY sk-...

Apres modification, rechargez votre shell ou executez source ~/.bashrc (ou l'equivalent pour votre shell).

Mode developpement

La variable YEEPILOT_DEV_MODE est un cas special. Elle ne prend effet que lorsqu'elle est utilisee avec une version de developpement de YeePilot (compilee avec le tag de build dev). Les binaires de production ignorent entierement cette variable.

# Fonctionne uniquement avec les builds de developpement
export YEEPILOT_DEV_MODE=1

Ceci est utilise par les contributeurs pendant le developpement et n'est pas pertinent pour une utilisation normale.

Verifier votre configuration

Pour voir quels parametres sont actifs (y compris les remplacements par variables d'environnement), executez :

yeepilot status

Cela affiche le fournisseur actuel, le modele, le mode de securite et les autres parametres actifs, en montrant d'ou provient chaque valeur.