référence · env

Variables d’environnementhermes v0.21.2

Les variables HERMES_* de la version 0.21.2 avec leur effet réel, documenté depuis le code source, et le chemin effectif du fichier .env.

01Les variables qui changent réellement le comportement

Le code source v0.21.2 référence 30 variables HERMES_*. Dix d’entre elles reviennent constamment ; voici leur effet mesuré dans le code.

Variable	Effet documenté
HERMES_ACCEPT_HOOKS	Autorise l’exécution des hooks déclarés par les skills.
HERMES_HOME	Racine de l’installation (~/.hermes par défaut). Profils, config et skills vivent en dessous.
HERMES_MAX_ITERATIONS	Plafond d’itérations d’outils par tour d’agent.
HERMES_PROFILE	Nom du profil actif : détermine le dossier de config et le cache.
HERMES_REDACT_SECRETS	Force la rédaction des secrets dans les sorties.
HERMES_SAFE_MODE	Mode sûr : actions destructrices bloquées.
HERMES_SESSION_ID	ID de session courant, injecté dans les environnements de scripts.
HERMES_USER_AGENT	User-Agent HTTP utilisé par les outils réseau.
HERMES_VERSION	Version de l’agent, lue par les checks de compatibilité.
HERMES_YOLO_MODE	Équivalent env de --yolo : saute les approbations.

Attention : les variables HERMES_SESSION_TOKEN__ et HERMES_AUTH_REQUIRED__ (double underscore final) sont des internes de la gateway : ne les exportez jamais à la main.

02Où les déclarer

Le fichier .env à la racine de HERMES_HOME est lu au démarrage ; les variables du shell ont priorité. Pour vérifier la chaîne effective :

$ hermes config env-path hermes config env-path

Chemin retourné sur notre installation de référence : /root/.hermes/profiles/ember/config.yaml