Assistant IA Hermes - Installation, configuration, flux de travail et dépannage

L’Agent Hermes est un assistant IA auto-hébergé, agnostique quant au modèle, qui fonctionne sur une machine locale ou un VPS à faible coût. Il opère 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.

Sa fonctionnalité est très similaire à celle de OpenClaw, une autre pile d’assistants auto-hébergés construite autour des outils, de la mémoire et du contrôle local. De nombreux développeurs ont trouvé leur chemin vers Hermes après que Anthropic ait bloqué l’accès à l’abonnement Claude d’OpenClaw en avril 2026 — la chronologie de l’ascension et de la chute d’OpenClaw explique pourquoi Hermes est devenu la destination naturelle pour les utilisateurs souhaitant une automatisation persistante et auto-hébergée sans dépendance au 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 d’IA relie ces sujets aux mêmes problèmes que Hermes tente de résoudre. Pour le modèle d’assistant à cinq couches — LLM, mémoire, outils, routage et observabilité — avec Hermes et OpenClaw comme implémentations de référence, consultez Architecture des assistants IA. Pour des données concrètes d’adoption — étoiles GitHub, volume quotidien de jetons sur OpenRouter, nombre de téléchargements sur PyPI, historique des CVE et sentiment de la communauté sur Reddit — OpenClaw vs Agent Hermes : Étoiles, téléchargements & utilisation 2026 suit comment Hermes se compare à 19 alternatives sur chaque signal mesurable.

Pour les compromis de déploiement et les choix d’exécution, Hébergement de LLM en 2026 : Comparaison des infrastructures locales, auto-hébergées et cloud fournit la carte des hébergements, tandis que Performance des LLM en 2026 : Benchmarks, goulots d’étranglement & optimisation couvre les aspects débit et latence une fois Hermes en fonctionnement. Si vous pointez régulièrement Hermes vers Qwen ou Gemma sur des runtimes locaux tels qu’Ollama, consolidez les préréglages de température et de pénalité pour l’utilisation d’outils multi-étapes avec Paramètres d’inférence LLM agentique pour Qwen et Gemma. Pour une carte compacte des commandes shell (hermes gateway, hermes memory, hermes doctor, raccourcis slash et plus encore), utilisez le rappel de la CLI de l’Agent Hermes. Si votre point d’entrée principal est la messagerie sur mobile, utilisez Contrôle vocal de Hermes depuis votre téléphone pour la pile vocale et la configuration spécifique à la plateforme.

Mon avis biaisé : Hermes est le plus intéressant lorsqu’il est traité comme une infrastructure, et non comme un onglet qu’on ouvre occasionnellement. Une fois qu’il fonctionne en tant que service et qu’il a un répertoire domicile stable, vos prompts commencent à ressembler moins à une “conversation” et plus à des “opérations”.

Ce qu’est l’Agent Hermes et pourquoi c’est 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, et plus encore) 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 unique fournisseur de modèles. Le flux de configuration officiel prend en charge plusieurs fournisseurs et tout point de terminaison 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 quand il doit agir, il le fait à travers des outils explicites et un backend d’exécution configurable. C’est là que se trouvent 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 ce que votre fournisseur facture. Si vous exécutez des modèles locaux, vous pouvez éviter entièrement les frais d’API.

Si votre configuration Hermes utilise Claude via des 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.

Installer l’Agent Hermes

Hermes possède 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 démarrez la CLI.

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

L’installeur n’est pas juste un simple wrapper. 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 prêt pour la première conversation.

Si vous arrivez d’un déploiement OpenClaw existant plutôt que de commencer à neuf, installez et validez d’abord un Hermes vide, puis suivez le basculement par étapes décrit dans Comment migrer d’OpenClaw vers l’Agent Hermes en toute sécurité — hermes claw migrate mappe la persona, la mémoire, les compétences, les fournisseurs et les serveurs MCP, mais les tâches cron, les plugins et le routage multi-agents doivent être reconstruits manuellement.

Notes sur 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.

Démarrage rapide

La première exécution la plus rapide est littéralement juste hermes, mais un démarrage rapide significatif implique deux décisions supplémentaires : quel fournisseur de modèles 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 à travers 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 Démarrage rapide officiel liste une gamme de fournisseurs et souligne également que Hermes fonctionne avec des API compatibles OpenAI. Cela compte parce que 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 Démarrage rapide suggère explicitement l’utilisation du terminal comme première fonctionnalité à essayer.

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

Exemple de prompt :

Montre-moi mon utilisation de disque et les cinq plus gros 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 regardez la configuration.

Configuration qui évolue

Hermes récompense ceux qui comprennent où il stocke son état et comment il résout la configuration. C’est aussi là que viennent nombreux les 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, 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, les compétences, le cron, les sessions et les journaux.

Cela compte pour deux raisons.

• Le dépannage devient mécanique parce que vous savez exactement où chercher.
• Les sauvegardes deviennent straightforward car un seul répertoire capture la majorité de l’état de l’agent qui vous importe.

Ordre de priorité de la configuration et maintien des secrets hors de config.yaml

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

Le joli détail 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 souhaitez garder certaines valeurs dans l’environnement tout en y faisant référence dans une configuration structurée.

Sandbox et backends 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 de voir les choses, avisé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 une manière propre de séparer votre appareil de chat de votre boîtier de calcul
• modal et daytona conviennent aux flux de travail “serverless mais assez persistants”
• singularity est l’option adaptée au HPC (calcul à haute performance)

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 la sécurité pour le backend Docker, tel que la suppression des capacités et la désactivation de l’élévation de privilèges.

Compétences, mémoire et profils

Hermes a deux mécanismes liés pour une valeur croissante.

Les compétences sont une mémoire procédurale. Hermes peut créer, mettre à jour et supprimer ses propres compétences et peut proposer d’enregistrer 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émanence plus profonde. Les documents de mémoire listent plusieurs plugins de fournisseurs, et le guide des fournisseurs de mémoire documente un flux de configuration interactif. Pour une analyse technique complète de la manière dont l’architecture de la mémoire fonctionne — instantanés figés, limites de caractères, les fournisseurs externes et la philosophie derrière une mémoire bornée — consultez Système de mémoire de l’Agent Hermes : Comment la mémoire persistante IA fonctionne réellement. Si vous souhaitez un fournisseur local et auto-hébergé avec un contrôle exceptionnellement granulaire sur ce qui est écrit automatiquement, consultez Mnemosyne pour l’Agent Hermes : Démarrage rapide de la mémoire locale — et Boucles de mémoire autoréforcez dans les agents IA pour comprendre pourquoi les valeurs par défaut d’écriture conservatrices sont importantes en premier lieu.

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

Pour un regard plus approfondi sur les compétences qui fonctionnent bien en production par rôle — ingénieurs, chercheurs, opérateurs et flux de travail exécutifs — consultez Compétences de l’assistant IA Hermes pour des configurations de production réelles. Lorsque vous êtes prêt à créer ou à déboguer vous-même les fichiers SKILL.md — métadonnées YAML, niveaux de divulgation progressive, visibilité conditionnelle et installations de hub — utilisez Création de compétences pour l’Agent Hermes — Structure et bonnes pratiques du SKILL.md.

Flux de travail typique

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

Une base stable

Une base qui ne pourrit pas tend à être :

1. Installez et exécutez une première conversation dans la CLI.
2. Choisissez un fournisseur et un modèle avec hermes model, puis confirmez les coûts.
3. Configurez les ensembles d’outils et décidez si l’exécution du terminal est locale ou sandboxée.
4. Apportez 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 le pensent parce que c’est le “slot 1” dans le prompt système.

Utilisation quotidienne qui cumule

Hermes a une interface en terminal plutôt qu’une interface web, et elle est conçue pour des sessions longues avec des commandes slash, des sessions reprenables et une sortie d’outils en flux continu. Les drapeaux shell, sous-commandes et raccourcis slash pour cette session sont dans le rappel de la CLI de l’Agent Hermes.

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 grand
• laisser Hermes transformer les routines répétitives en compétences
• garder 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 ressentir Hermes comme un assistant plutôt qu’une application de terminal. Les documents la décrivent comme un processus unique qui se connecte à plusieurs plateformes, gère les sessions, exécute les tâches cron et livre les messages.

La configuration est invoquée via hermes gateway setup, et la passerelle peut fonctionner au premier plan ou en tant que service utilisateur. La référence CLI documente les sous-commandes de passerelle comme run, install, start, stop, status et restart. Si vous souhaitez que ce modèle de passerelle fonctionne sur un serveur dédié tout en vous connectant depuis un client de bureau séparé, utilisez Serveur sans écran et configuration du bureau distant pour l’Agent Hermes.

Pour les filets d’attente multi-agents et la planification contrôlée, consultez 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 batch basé sur cron.

La sécurité pour un bot utilisant des outils est importante. Les documents de passerelle décrivent des listes blanches pour des plateformes spécifiques et un flux d’appairage DM qui émet des codes d’appairage à usage unique et exige 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 parce que les gens ne vérifient que 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 la boucle de base :

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

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 correctifs, 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, les documents fournissent 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. Il souligne également un piège courant : les clés sont spécifiques au fournisseur.

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

Les limites de débit et les problèmes 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 du backend terminal” et pointe les causes typiques par backend, y compris Docker non fonctionnel et variables SSH manquantes. Il note également que le retour à local est une démarche de débogage valide lorsque la configuration de la sandbox est en question.

Pour les problèmes de passerelle, le guide de messagerie met en avant les listes blanches et l’appairage comme valeurs par défaut sûres, ce qui signifie que de nombreux incidents de type “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 persistante IA fonctionne réellement
• Compétences de l’assistant IA Hermes pour des configurations de production réelles