Commande hermes setup — Référence Complète & Exemples

Vue d’ensemble

hermes setup est l’assistant de configuration interactif d’Hermes Agent. Exécuté sans argument, il lance l’assistant complet, qui rejoue la configuration en affichant vos valeurs actuelles comme valeurs par défaut. Vous pouvez également cibler une seule section en passant son nom en argument.

Utilisation

hermes setup [-h] [--non-interactive] [--reset] [--reconfigure] [--quick] [--portal]
             [{model,tts,terminal,gateway,tools,telemetry,agent}]

Sections de configuration

Exécutez une section spécifique au lieu de l’assistant complet :

Section	Ce qu’elle configure
`model`	Modèle par défaut, fournisseur et identifiants API
`tts`	Fournisseur de synthèse vocale et réglages de voix
`terminal`	Backend de terminal (local, docker, ssh, modal) et valeurs par défaut
`gateway`	Plateformes de messagerie (Telegram, Discord, Slack, etc.)
`tools`	Quels toolsets sont activés par défaut
`telemetry`	Analytique d’utilisation et préférences de télémétrie
`agent`	Comportement de l’agent, itérations maximales et valeurs de session

hermes setup model
hermes setup gateway
hermes setup tools

Options

Option	Description
`--non-interactive`	Mode non interactif (utilise les valeurs par défaut/variables d’environnement)
`--reset`	Réinitialise la configuration aux valeurs par défaut
`--reconfigure`	(Par défaut sur les installations existantes.) Relance l’assistant complet en affichant les valeurs actuelles comme valeurs par défaut. Conservé pour compatibilité — un simple `hermes setup` fait désormais cela.
`--quick`	Sur les installations existantes : ne demande que les éléments manquants ou non définis, au lieu de lancer l’assistant de reconfiguration complet
`--portal`	Configuration unique Nous Portal : connexion OAuth, choix d’un modèle Nous, définition de Nous comme fournisseur d’inférence et activation du Tool Gateway. Ignore le reste de l’assistant.

Exemples

# Lancer l'assistant complet (reconfigure avec les valeurs actuelles par défaut)
hermes setup

# Configurer uniquement la section modèle
hermes setup model

# Configurer la passerelle de messagerie
hermes setup gateway

# Tout réinitialiser aux valeurs par défaut
hermes setup --reset

# Ne demander que les éléments manquants ou non définis
hermes setup --quick

# Configuration unique Nous Portal avec OAuth
hermes setup --portal

# Configuration non interactive pour scripts/CI
hermes setup --non-interactive

Astuces

Sur les installations existantes, un simple hermes setup relance l’assistant avec vos valeurs actuelles par défaut — il peut être réexécuté en toute sécurité à tout moment.
Utilisez --quick pour n’être interrogé que sur les éléments manquants ou non définis.
Utilisez --non-interactive pour les configurations headless ou scriptées, en vous appuyant sur les valeurs par défaut et les variables d’environnement.
Après la configuration, exécutez hermes doctor pour vérifier que tout est complet et fonctionnel.
Pour un seul changement, hermes config set key value est plus rapide que l’assistant complet.