Guide complet d'installation et de configuration
Hermes Agent 2026 : tutoriel pas à pas avec un cas pratique

Un lancement réussi n'est que la première étape. L'essentiel : le modèle répond-il, les fichiers restent-ils dans les limites prévues, les journaux sont-ils traçables, les échecs sont-ils diagnostiquables ? Le cas pratique ici n'est pas un article workflow à part — il prouve que l'installation et la configuration fonctionnent réellement, pour que vous puissiez ensuite étendre vers de vrais workflows Hermes Agent en toute confiance.

1Définir d'abord le cas pratique

Votre premier cas doit être à faible risque, réversible et vérifiable — pas un dépôt de production ni un dossier privé dès le premier jour.

Créez la structure une fois avant la vérification :

2Préparer l'environnement d'installation pour le cas

• →Matériel : Mac Apple Silicon ou Intel ; ≥16 Go de RAM et ≥5 Go d'espace disque recommandés. Confirmez puce et OS avec uname -m et sw_vers.
• →Dépendances : seul git --version est requis au départ ; Python 3.11, Node v22, ripgrep et ffmpeg sont gérés par l'installateur officiel.
• →Réseau : accès à GitHub raw et à votre point d'API LLM (OpenRouter, Anthropic, etc.).
• →Compte : au moins une clé API fournisseur ; stockez les secrets uniquement dans ~/.hermes/.env avec chmod 600.
• →Permissions : compte admin local ; acceptez les invites de confidentialité macOS lors de la première utilisation des outils fichier ou terminal.

3Installer Hermes Agent et confirmer la version

Puis source ~/.zshrc et lancez hermes setup ou hermes model selon le flux officiel. Après installation, vérifiez :

• ✓which hermes → généralement ~/.local/bin/hermes
• ✓hermes doctor sans blocage (clé manquante → configurez un modèle)
• ✓hermes update affiche votre version ; code dans ~/.hermes/hermes-agent/, données sous ~/.hermes/

N'avancez pas vers la configuration du cas tant que hermes doctor n'est pas validé.

4Configurer modèle et clé API pour le cas

Lancez hermes model pour choisir un fournisseur et un modèle par défaut (noms et facturation évoluent — consultez le site du fournisseur). Vous pouvez aussi écrire ~/.hermes/.env, par exemple :

Test de connectivité : depuis ~/hermes-lab, démarrez hermes et envoyez « réponds OK ». En cas d'erreur API, lancez hermes config check avant de continuer le cas.

5Définir les limites de répertoire et les permissions

Pour la première vérification, travaillez dans le dossier de test : cd ~/hermes-lab avant de lancer hermes. Si vous utilisez plus tard la Messaging Gateway, définissez MESSAGING_CWD=~/hermes-lab dans ~/.hermes/.env pour que l'agent ne démarre pas depuis un chemin sensible (voir le guide de sécurité officiel).

• →Conservez approvals.mode: manual (défaut) — les commandes dangereuses exigent une approbation humaine.
• →Isolation avancée : terminal.backend: docker dans ~/.hermes/config.yaml (recommandé pour Gateway en production).
• →Ne mettez jamais de clés API dans des fichiers sous ~/hermes-lab susceptibles d'être versionnés par Git.

6Portes de contrôle avant le cas complet

• ①Ping modèle : la conversation renvoie une réponse normale
• ②Lecture fichier : demandez à l'agent de résumer le premier paragraphe de input/notes.md
• ③Écriture fichier : créez output/ping.txt contenant ok
• ④Vérifier les journaux : ls ~/.hermes/logs/ — les sessions CLI doivent être traçables

Si une porte échoue, dépannez à ce niveau avant d'exécuter le cas complet.

7Exécuter le cas pratique complet

Depuis ~/hermes-lab, lancez hermes avec une consigne claire (copiez et adaptez) :

Si des commandes de suppression ou de configuration système apparaissent, refusez-les à l'invite d'approbation CLI — cela confirme que vos réglages de sécurité sont actifs.

8Vérifier, dépanner et confirmer le retour arrière

Diagnostic des échecs par couche :

• →hermes: command not found → couche installation : PATH, source ~/.zshrc
• →401 / pas de réponse modèle → couche modèle : hermes model, permissions .env
• →Impossible de lire/écrire → couche permissions : répertoire de travail, MESSAGING_CWD, autorisations macOS
• →Erreurs config hermes doctor → couche configuration : hermes config migrate
• →Boucles d'outils ou sortie hors sujet → couche tâche : raccourcir la consigne, fixer les chemins de sortie

9Passer du cas de test aux vrais workflows

Après validation du cas, étendez permissions et automatisation par étapes — sans sauter la vérification :

• 1Accès lecture seule aux dossiers sources réels ; sorties dans un répertoire draft/ séparé
• 2Configurez hermes gateway setup + gateway install pour la persistance launchd (plist dans ~/Library/LaunchAgents/ai.hermes.gateway.plist)
• 3Pour plus d'automatisation, évaluez le backend Docker, les listes blanches de commandes et d'utilisateurs plateforme

Pour une checklist pré-installation plus complète, consultez notre liste d'installation Hermes Agent sur Mac.

10Exécuter le cas sur Mac mini, c'est plus simple

L'installation, la configuration et les contrôles de journaux de ce guide tournent nativement sur macOS — Terminal, Homebrew, Docker et launchd sans WSL. Le Mac mini M4 consomme environ 4 W au repos ; la mémoire unifiée Apple Silicon en fait un excellent nœud silencieux pour Hermes CLI et Gateway en continu. Gatekeeper et FileVault réduisent aussi l'exposition lorsqu'un agent reste en ligne.

Si vous transformez ce cas de test en workflow 7×24, le Mac mini M4 est un point de départ matériel économique — procurez-vous-en un maintenant et exécutez installation et configuration sur une machine conçue pour le fonctionnement permanent.