Assistant IA Hermes - Installation, Configuration, Flux de Travail et Dépannage

L’agent Hermes est un assistant IA auto-hébergé et agnostique au modèle qui s’exécute sur une machine locale ou un VPS à bas coût, fonctionne via des interfaces de terminal et de messagerie, et s’améliore avec le 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, une autre pile d’assistants auto-hébergée construite autour d’outils, de la mémoire et du contrôle local. De nombreux développeurs ont découvert Hermes après que Anthropic a bloqué l’accès à l’abonnement Claude d’OpenClaw en avril 2026 — la chronologie de l’essor et de la chute d’OpenClaw explique pourquoi Hermes est apparu comme la destination naturelle pour les utilisateurs souhaitant une automatisation persistante et auto-hébergée sans dépendre d’un fournisseur.

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

Pour les compromis de déploiement et les choix de temps d’exécution, L’hébergement des LLM en 2026 : Infrastructure locale, auto-hébergée et cloud comparée fournit la carte d’hébergement, tandis que Les performances des LLM en 2026 : Benchmarks, goulots d’étranglement et optimisation couvre l’aspect débit et latence une fois Hermes en cours d’exécution. Pour une carte compacte des commandes shell (hermes gateway, hermes memory, hermes doctor, raccourcis slash, etc.), utilisez la feuille de triche CLI de l’agent Hermes.

Mon avis biaisé : Hermes est le plus intéressant lorsqu’il est traité comme une infrastructure, et non comme un onglet que l’on ouvre occasionnellement. Une fois qu’il fonctionne en tant que service et possède un répertoire d’accueil stable, vos prompts ressemblent moins à du “chat” et plus à de l’“ops”.

Qu’est-ce que l’agent Hermes et pourquoi est-il important

L’agent Hermes est un agent IA open-source développé par Nous Research. Il est conçu pour fonctionner 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 le reste de ce guide.

Premièrement, Hermes n’est pas verrouillé à un seul fournisseur de modèles. Le flux d’installation officiel prend en charge plusieurs fournisseurs et tout point de terminaison compatible avec OpenAI, et le changement se fait 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 a besoin d’agir, il le fait par le biais d’outils explicites et d’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. L’agent Hermes lui-même est un logiciel libre sous licence MIT. Si vous utilisez des modèles hébergés, le coût récurrent est celui que votre fournisseur facture. Si vous exécutez des modèles locaux, vous pouvez éviter totalement les frais d’API.

Si votre configuration Hermes utilise Claude par l’intermédiaire de couches d’outils externes, ce changement d’abonnement Anthropic est une référence utile sur la raison pour laquelle la facturation basée sur l’API est désormais la voie attendue.

Installation de l’agent Hermes

Hermes offre un chemin d’installation rapide pour Linux, macOS et WSL2. La documentation officielle le garde intentionnellement simple.

Installation de Hermes sur Linux

sudo apt-get update
sudo apt-get upgrade
sudo apt-get curl git
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Après l’installation, rechargez votre shell et lancez le 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 état initial prêt pour le chat.

Remarques 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 des dépendances et de l’environnement en conséquence.

Prise en main rapide

La première exécution la plus rapide est littéralement juste hermes, mais une prise en main significative implique deux décisions supplémentaires : quel fournisseur de modèle utiliser et quels outils doivent être activés.

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 exécuter un assistant interactif sur les domaines de configuration majeurs

Un flux minimal ressemble à ceci :

hermes model
hermes tools
hermes

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

Prouver l’exécution des outils tôt

Avant de créer des habitudes autour de Hermes, il vaut la peine 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é à essayer.

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

Exemple de prompt :

Affiche mon utilisation du disque et les cinq plus grands répertoires.

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

Configuration qui évolue

Hermes récompense ceux qui comprennent où il stocke l’état et comment il résout la configuration. C’est aussi d’où proviennent nombreux problèmes de type “ça marchait hier”.

Où se trouvent la configuration et l’état

Hermes stocke ses paramètres et son état sous ~/.hermes. Le guide de configuration officiel documente la structure, incluant 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, les compétences, cron, les sessions et les journaux.

Cela est important pour deux raisons.

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

Précedence de configuration et maintien des secrets hors de config.yaml

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

Le détail agréable 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 à l’intérieur de config.yaml via la syntaxe ${VAR_NAME}. Cela est utile lorsque vous souhaitez conserver certaines valeurs dans l’environnement tout en les référençant dans la configuration structurée.

Sandboxes et backends d’exécution

Hermes prend en charge plusieurs backends terminaux 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 avisée mais non évangélique de penser à ceci est :

• 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 s’adaptent aux flux de travail “serverless mais assez persistants”
• singularity est l’option amicale pour le calcul haute performance (HPC)

Un 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 possè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 un rappel plus profond. La documentation sur la mémoire liste plusieurs plugins de fournisseur, et le guide des fournisseurs de mémoire documente un flux de configuration interactif. Pour une analyse technique complète de la façon dont l’architecture de mémoire fonctionne — snapshots gelés, limites de caractères, les huit fournisseurs externes et la philosophie derrière la mémoire bornée — voir Système de mémoire de l’agent Hermes : comment la mémoire IA persistante fonctionne réellement.

Si vous souhaitez plusieurs agents indépendants sur la même machine, les profils Hermes fournissent l’isolation. Chaque profil obtient son propre répertoire avec sa propre configuration, ses secrets, ses mémoires, ses sessions, ses compétences, ses tâches cron et l’état du gateway.

Pour un examen plus approfondi des compétences qui fonctionnent bien en production par rôle — ingénieurs, chercheurs, opérateurs et flux de travail exécutifs — voir Compétences de l’assistant IA Hermes pour les configurations de production réelles. Lorsque vous êtes prêt à rédiger ou déboguer les fichiers SKILL.md eux-mêmes — métadonnées YAML, niveaux de divulgation progressive, visibilité conditionnelle et installations hub — utilisez Rédaction de compétences pour l’agent Hermes — Structure SKILL.md et meilleures pratiques.

Flux de travail typique

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

Une base stable

Une base qui a tendance à ne pas se corrompre est :

1. Installer et exécuter un premier chat dans le 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. Faire un changement rapide à SOUL.md seulement après avoir utilisé la valeur par défaut pendant un certain temps. Les changements d’identité comptent plus que les gens ne l’attendent car c’est le “slot 1” du prompt système.

Utilisation quotidienne qui s’accumule

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

En pratique, une cadence utile est :

• exécuter le travail dans une session nommée pour un projet
• compresser le contexte lorsqu’il devient trop volumineux
• laisser à Hermes le soin de transformer les routines répétitives en compétences
• maintenir une frontière mentale entre “demander” et “agir” afin 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 tâches 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 en tant que service utilisateur. La référence CLI documente les sous-commandes de la passerelle comme run, install, start, stop, status et restart.

Pour les files d’attente multi-agents et la planification contrôlée, voir Kanban dans l’agent Hermes pour les flux de travail LLM auto-hébergés, qui couvre les limites du dispatcher, les chaînes de dépendances et le lotissement basé sur cron.

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 première classe. 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 parce que les gens ne vérifient que la couche de modèle et ignorent la couche de temps d’exécution.

Commandes de triage rapide

La référence CLI positionne explicitement trois commandes comme le cœur de la boucle :

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

Pour les journaux, hermes logs fait la queue des 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 correctifs, incluant les problèmes de version Python, uv non trouvé, et les problèmes de permission causés par le mélange d’installations sudo et d’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 réexécuter hermes model, ou de définir une clé directement via hermes config set. Elle souligne également une astuce courante : les clés sont spécifiques au fournisseur.

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

Les limites de taux et les problèmes de longueur de contexte sont également couverts. La FAQ suggère d’attendre pour les erreurs 429, de changer de fournisseur ou de modèle, et de réduire la pression de contexte 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 sur les “problèmes courants du backend terminal” et pointe vers les causes typiques par backend, incluant Docker non en cours d’exécution et variables SSH manquantes. Il note également que revenir à local est une démarche de débogage valide lorsque la configuration du sandbox est en question.

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

Références

• Page d’accueil de l’agent Hermes
• Système de mémoire de l’agent Hermes : comment la mémoire IA persistante fonctionne réellement
• Compétences de l’assistant IA Hermes pour les configurations de production réelles