Assistant IA Hermès - Installation, configuration, flux de travail et dépannage

Hermes Agent est un assistant IA auto-hébergé, agnostique vis-à-vis des modèles, qui s’exécute sur une machine locale ou un VPS à faible coût, fonctionne via des interfaces de terminal et de messagerie, et s’améliore au fil du temps en transformant les tâches répétitives en compétences réutilisables.

Il est très similaire en termes de fonctionnalités à OpenClaw, un autre ensemble d’assistants auto-hébergés construit autour d’outils, de la mémoire et du contrôle local.

Si vous souhaitez avoir une vision plus large des assistants auto-hébergés, de la récupération et de l’infrastructure locale autour de Hermes, cette vue d’ensemble des systèmes d’IA relie ces sujets aux mêmes problèmes que Hermes tente de résoudre.

Pour les compromis de déploiement et les choix d’exécution, Hébergement LLM en 2026 : Comparaison des infrastructures locales, auto-hébergées et cloud fournit la carte d’hébergement, tandis que Performance LLM en 2026 : Benchmarks, goulots d’étranglement et optimisation couvre les aspects du débit et de la latence une fois que Hermes est en cours d’exécution.

Mon avis biaisé : Hermes est le plus intéressant lorsqu’il est traité comme une infrastructure, et non comme un onglet que vous ouvrez occasionnellement. Une fois qu’il fonctionne comme un service et dispose d’un répertoire stable, vos prompts ressemblent moins à une “conversation” et plus à de l’“exploitation” (ops).

Ce qu’est Hermes Agent et pourquoi cela compte

Hermes Agent est un agent IA open-source développé par Nous Research. Il est conçu pour s’exécuter de manière persistante, utiliser des outils (terminal, fichiers, web, etc.) et améliorer son propre comportement au fil du temps grâce à un système de compétences et de mémoire.

Deux choix de conception méritent d’être explicités car ils façonnent tout le reste de ce guide.

Premièrement, Hermes n’est pas verrouillé sur un seul fournisseur de modèles. Le flux d’installation officiel prend en charge plusieurs fournisseurs et toute fin de point compatible avec OpenAI, et le changement s’effectue via la commande hermes model plutôt que par des modifications de code.

Deuxièmement, Hermes trace une ligne dure entre la “conversation” et l’“exécution”. L’agent peut parler toute la journée, mais lorsqu’il doit agir, il le fait via des outils explicites et un backend d’exécution configurable. C’est là que résident la sécurité, la reproductibilité et le dépannage.

Les coûts et la licence sont rafraîchissamment ennuyeux. Hermes Agent lui-même est un logiciel gratuit sous licence MIT. Si vous utilisez des modèles hébergés, le coût récurrent est celui de votre fournisseur. Si vous exécutez des modèles locaux, vous pouvez éviter entièrement les frais d’API.

Installation de Hermes Agent

Hermes dispose d’un chemin d’installation rapide pour Linux, macOS et WSL2. La documentation officielle le garde délibérément simple.

Installation en une ligne

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Après l’installation, rechargez votre shell et lancez la CLI.

source ~/.bashrc   # ou source ~/.zshrc
hermes

L’installateur n’est pas seulement une fine enveloppe. Selon le guide d’installation, il configure les dépendances, le dépôt, un environnement virtuel et la commande hermes, puis vous amène à un premier état prêt à chatter.

Notes pour Windows et Android

Windows natif n’est pas pris en charge. La documentation recommande WSL2 et l’exécution de Hermes à l’intérieur.

Pour Android, Hermes prend en charge un chemin d’installation Termux. Il est conçu pour détecter Termux et adapter sa configuration de dépendances et d’environnement en conséquence.

Démarrage rapide

Le premier lancement le plus rapide est littéralement juste hermes, mais un démarrage rapide significatif implique deux décisions supplémentaires : quel fournisseur de modèle utiliser et quels outils activer.

Choisir un fournisseur et un modèle

Hermes expose trois points d’entrée complémentaires :

• hermes model pour choisir un fournisseur et un modèle par défaut
• hermes tools pour activer ou désactiver des ensembles d’outils
• hermes setup pour lancer un assistant interactif couvrant les zones de configuration majeures

Un flux minimal ressemble à ceci :

hermes model
hermes tools
hermes

En termes de ce qui est réellement pris en charge, le Quickstart officiel répertorie une gamme de fournisseurs et précise également que Hermes fonctionne avec des API compatibles OpenAI. Cela importe car cela inclut à la fois des services hébergés et des points de terminaison auto-hébergés.

Prouver l’exécution d’outils dès le début

Avant de créer des habitudes autour de Hermes, il est utile de vérifier que l’utilisation des outils fonctionne dans votre environnement. Le Quickstart suggère explicitement l’utilisation du terminal comme première fonctionnalité à tester.

En pratique, un petit prompt de “test de fumée” remplit deux fonctions : il vérifie l’outil terminal et valide les invites de permission.

Exemple de prompt :

Affichez mon utilisation de disque et les cinq plus grands répertoires.

Si Hermes ne peut pas exécuter l’outil terminal, passez directement à la section Dépannage. La mauvaise configuration du backend terminal est l’une des causes les plus courantes, et la correction est généralement évidente une fois que vous examinez la configuration.

Configuration évolutive

Hermes récompense ceux qui comprennent où il stocke son état et comment il résout sa configuration. C’est aussi là que naissent beaucoup de problèmes de type “ça marchait hier”.

Où vivent la configuration et l’état

Hermes stocke ses paramètres et son état sous ~/.hermes. Le guide de configuration officiel documente la structure, y compris config.yaml pour les paramètres, .env pour les secrets, auth.json pour les identifiants OAuth, SOUL.md pour l’identité, et des dossiers pour les mémoires, compétences, cron, sessions et journaux.

Cela compte pour deux raisons.

• Le débogage devient mécanique car vous savez exactement où chercher.
• Les sauvegardes deviennent simples car un seul répertoire capture la majeure partie de l’état de l’agent qui vous intéresse.

Précedence de configuration et exclusion des secrets de config.yaml

Hermes résout la configuration avec un ordre de priorité. En haut se trouvent les overrides CLI, puis config.yaml, puis .env, avec les valeurs par défaut intégrées en bas.

Le détail intéressant est que hermes config set achemine les valeurs vers le bon fichier : les clés API vers .env et les paramètres non secrets vers config.yaml.

hermes config set model openrouter/meta-llama/llama-3.1-70b-instruct
hermes config set terminal.backend docker
hermes config set OPENROUTER_API_KEY sk-or-v1-xxxxxxxx

Hermes prend également en charge la substitution de variables d’environnement dans config.yaml via la syntaxe ${VAR_NAME}. Cela est utile lorsque vous voulez garder certaines valeurs dans l’environnement tout en les référençant dans une configuration structurée.

Backends de sandbox et d’exécution

Hermes prend en charge plusieurs backends de terminal qui définissent où les commandes shell s’exécutent réellement. Le guide de configuration liste local, docker, ssh, modal, daytona et singularity.

La manière d’y voir les choses, opinionnée mais non évangélique, est la suivante :

• local est le plus rapide et le plus simple, mais il n’est pas isolé
• docker est une couche de sécurité et de reproductibilité pragmatique
• ssh est un moyen propre de séparer votre appareil de chat de votre boîte de calcul
• modal et daytona conviennent aux workflows “serverless mais suffisamment persistants”
• singularity est l’option conviviale pour le HPC (calcul haute performance)

Exemple minimal de backend Docker :

# ~/.hermes/config.yaml
terminal:
  backend: docker
  docker_image: "nikolaik/python-nodejs:python3.11-nodejs20"
  docker_volumes:
    - "/home/user/projects:/workspace/projects"
  docker_forward_env:
    - "GITHUB_TOKEN"

La documentation décrit également le durcissement de sécurité pour le backend Docker, tel que la suppression des capacités et la désactivation de l’escalade de privilèges.

Compétences, mémoire et profils

Hermes dispose de deux mécanismes liés pour accumuler de la valeur.

Les compétences sont une mémoire procédurale. Hermes peut créer, mettre à jour et supprimer ses propres compétences et peut proposer de sauvegarder une approche en tant que compétence après avoir terminé une tâche complexe.

La mémoire intégrée est stockée sous forme de fichiers comme MEMORY.md et USER.md sous ~/.hermes, et Hermes peut également utiliser des fournisseurs de mémoire externes pour une récupération plus profonde. Les documents sur la mémoire listent plusieurs plugins de fournisseurs, et le guide des fournisseurs de mémoire documente un flux de configuration interactif.

Si vous souhaitez plusieurs agents indépendants sur la même machine, les profils Hermes fournissent une isolation. Chaque profil obtient son propre répertoire avec sa propre configuration, ses propres secrets, mémoires, sessions, compétences, jobs cron et état de passerelle.

Flux de travail typique

Si vous traitez Hermes comme un agent que vous garderez, le flux de travail commence à ressembler à de l’ingénierie de service.

Une base stable

Une base qui a tendance à ne pas se détériorer est :

1. Installer et lancer un premier chat dans la CLI.
2. Choisir un fournisseur et un modèle avec hermes model, puis confirmer les coûts.
3. Configurer les ensembles d’outils et décider si l’exécution du terminal est locale ou sandboxée.
4. Apporter une modification rapide à SOUL.md seulement après avoir utilisé les paramètres par défaut pendant un moment. Les changements d’identité comptent plus que les gens ne le pensent car c’est le “slot 1” du prompt système.

Utilisation quotidienne qui s’accumule

Hermes dispose d’une interface utilisateur en terminal plutôt que web, et il est conçu pour des sessions longues avec des commandes slash, des sessions reprenables et un streaming de sortie d’outils.

En pratique, un rythme utile est :

• exécuter le travail dans une session nommée pour un projet
• compresser le contexte lorsqu’il devient trop volumineux
• laisser Hermes transformer les routines répétées en compétences
• maintenir une frontière mentale entre “demander” et “agir” pour que l’exécution des outils reste auditable

Passerelle de messagerie pour un accès 24/7

La passerelle de messagerie est la pièce qui fait sentir Hermes comme un assistant plutôt qu’une application de terminal. La documentation la décrit comme un processus unique qui se connecte à plusieurs plateformes, gère les sessions, exécute des jobs cron et livre des messages.

La configuration est invoquée via hermes gateway setup, et la passerelle peut s’exécuter au premier plan ou comme un service utilisateur. La référence CLI documente les sous-commandes de passerelle comme run, install, start, stop, status et restart.

La sécurité pour un bot utilisant des outils est importante. La documentation de la passerelle décrit des listes blanches pour des plateformes spécifiques et un flux d’appariement DM qui émet des codes d’appariement à usage unique et nécessite une approbation via hermes pairing approve.

Mises à jour sans drame

Les mises à jour de Hermes sont une commande de premier ordre. Le guide de mise à jour documente hermes update, les vérifications de migration de configuration et une petite routine de validation post-mise à jour incluant hermes doctor et hermes gateway status.

hermes update
hermes doctor
hermes gateway status

Dépannage et diagnostics

La plupart des échecs de Hermes ne sont pas mystérieux. Ils semblent mystérieux car les gens vérifient uniquement la couche modèle et ignorent la couche d’exécution.

Commandes de triage rapide

La référence CLI positionne explicitement trois commandes comme le cycle central :

• hermes doctor pour des diagnostics interactifs
• hermes status pour un aperçu rapide
• hermes dump pour un résumé de configuration partageable et masqué

Pour les journaux, hermes logs suit les fichiers stockés sous ~/.hermes/logs.

hermes doctor --fix
hermes status
hermes dump --show-keys
hermes logs errors -f

Échecs d’installation courants

La FAQ et le guide de dépannage listent plusieurs problèmes récurrents et leurs corrections, y compris les problèmes de version Python, uv non trouvé, et les problèmes de permission causés par le mélange d’installations sudo avec des installations utilisateur.

Si vous rencontrez ces erreurs, la documentation fournit des étapes de remédiation spécifiques telles que la mise à niveau de Python, l’installation de uv, et la réinstallation de Hermes sans sudo.

Problèmes de fournisseur et de modèle

Lorsque les clés API ne fonctionnent pas, la FAQ recommande de vérifier la configuration, de relancer hermes model, ou de définir une clé directement via hermes config set. Elle signale également un piège courant : les clés sont spécifiques au fournisseur.

Pour les problèmes de “modèle non trouvé”, la FAQ renvoie vers l’utilisation de hermes model pour choisir un identifiant valide et montre à la fois les overrides de configuration et par session.

Les problèmes de limitation de débit et de longueur de contexte sont également couverts. La FAQ suggère d’attendre les erreurs 429, de changer de fournisseur ou de modèle, et de réduire la pression contextuelle via la compression ou une nouvelle session.

Problèmes de backend terminal et de passerelle

Si les commandes du terminal échouent immédiatement, le guide de configuration inclut une section “problèmes courants de backend terminal” et pointe vers les causes typiques par backend, y compris Docker non en cours d’exécution et les variables SSH manquantes. Il note également que revenir à local est une manœuvre de débogage valide lorsque la configuration de sandbox est en question.

Pour les problèmes de passerelle, le guide de messagerie met en avant les listes blanches et l’appariement comme paramètres de sécurité par défaut, ce qui signifie que de nombreux incidents de “bot silencieux” sont en réalité l’autorisation qui fait son travail.

Références

• Page d’accueil de Hermes Agent