Assistant IA Hermes – Installation, configuration, flux de travail et dépannage
Installation et prise en main rapide de l’agent Hermes pour les développeurs
Hermes Agent est un assistant d’IA auto-hébergé, agnostique envers les modèles, qui fonctionne sur une machine locale ou un VPS à faible coût. Il opère via des interfaces en 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, un autre stack d’assistant auto-hébergé construit 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 a bloqué l’accès par abonnement Claude à OpenClaw en avril 2026 — la chronologie de la montée 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 vision 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 cherche à résoudre. Pour le modèle d’assistant à cinq couches — LLM, mémoire, outillage, routage et observabilité — avec Hermes et OpenClaw comme implémentations de référence, consultez Architecture d’Assistant IA. Pour des données concrètes sur l’adoption — étoiles GitHub, volume quotidien de jetons OpenRouter, nombre de téléchargements PyPI, historique CVE et sentiment de la communauté Reddit — OpenClaw vs Hermes Agent : É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 d’hébergement, tandis que Performance des LLM en 2026 : Benchmarks, Goulets d’étranglement & Optimisation couvre l’aspect débit et latence une fois Hermes en marche. 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 agentic LLM pour Qwen et Gemma. Pour une carte compacte des commandes shell (hermes gateway, hermes memory, hermes doctor, raccourcis slash, et plus encore), utilisez la feuille de triche CLI Hermes Agent. Si votre point d’entrée principal est la messagerie sur mobile, utilisez Contrôle vocal de Hermes depuis votre téléphone pour le stack vocal 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 que l’on ouvre occasionnellement. Une fois qu’il fonctionne comme un service et qu’il a un répertoire d’accueil stable, vos prompts ressemblent moins à une « conversation » et plus à des « opérations ».
Qu’est-ce que Hermes Agent et pourquoi est-ce important
Hermes Agent est un agent d’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 seul fournisseur de modèles. Le processus de configuration officiel prend en charge plusieurs fournisseurs et tout endpoint 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 « conversation » et « exécution ». L’agent peut parler toute la journée, mais lorsqu’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îchissante ennuyeux. Hermes Agent lui-même est un logiciel gratuit sous la 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 entièrement les frais d’API.
Si votre configuration de Hermes utilise Claude à travers des couches d’outillage 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 le chemin attendu.
Installer Hermes Agent
Hermes propose un chemin d’installation rapide pour Linux, macOS et WSL2. Les documents officiels le gardent volontairement simple.
Installation de Hermes sur Linux
sudo apt-get update
sudo apt-get upgrade
sudo apt-get install 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’installateur n’est pas qu’un simple wrapper mince. 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 pour le chat.
Si vous arrivez depuis un déploiement OpenClaw existant plutôt que de partir de zéro, installez et validez d’abord un Hermes vide, puis suivez la bascule progressive dans Comment migrer d’OpenClaw vers Hermes Agent 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 à la main.
Notes pour Windows et Android
Windows natif n’est pas pris en charge. Les documents recommandent 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 modelpour choisir un fournisseur et un modèle par défauthermes toolspour activer ou désactiver des ensembles d’outilshermes setuppour exécuter un assistant interactif sur les principales zones de configuration
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 souligne également que Hermes fonctionne avec les API compatibles OpenAI. Cela compte car cela inclut à la fois les services hébergés et les endpoints auto-hébergés.
Prouver l’exécution des outils tôt
Avant de construire 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 « test de fumée » fait deux tâches : il vérifie l’outil terminal et il valide les invites de permission.
Exemple de prompt :
Show my disk usage and the five largest directories.
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 passe à l’échelle
Hermes récompense ceux qui comprennent où il stocke son état et comment il résout la configuration. C’est aussi là que proviennent de nombreux problèmes « ç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 disposition, 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 la mémoire, les compétences, le cron, les sessions et les journaux.
Cela compte pour deux raisons.
- Le débogage devient mécanique car vous savez exactement où regarder.
- Les sauvegardes deviennent simples car un seul répertoire capture la plupart de l’état de l’agent qui vous intéresse.
Précedence de la configuration et exclusion des secrets de config.yaml
Hermes résout la configuration avec un ordre de précedence. Au sommet se trouvent les surcharges CLI, puis config.yaml, puis .env, avec les valeurs par défaut intégrées en bas.
Le bel 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 conserver certaines valeurs dans l’environnement tout en les référenceant 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 répertorie local, docker, ssh, modal, daytona et singularity.
La manière avisée mais non évangéliste de penser cela est :
localest le plus rapide et le plus simple, mais il n’est pas isolédockerest une couche pragmatique de sécurité et de reproductibilitésshest une façon propre de séparer votre appareil de chat de votre boîte de calculmodaletdaytonaconviennent aux flux de travail « serverless mais persistants suffisants »singularityest l’option conviviale pour le 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"
Les documents décrivent également le durcissement de la sécurité pour le backend Docker, tel que le dépôt de 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 composer la valeur.
Les compétences sont la mémoire procédurale. Hermes peut créer, mettre à jour et supprimer ses propres compétences et peut proposer de sauvegarder une approche comme une 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 approfondi. Les documents de mémoire réperticient 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 — instantanés figés, limites de caractères, les fournisseurs externes et la philosophie derrière la mémoire bornée — consultez Système de Mémoire Hermes Agent : Comment la Mémoire IA Persistante Fonctionne Vraiment. Si vous souhaitez un fournisseur local, auto-hébergé avec un contrôle exceptionnellement granulaire sur ce qui est automatiquement écrit, consultez Mnemosyne pour Hermes Agent : Démarrage rapide de la Mémoire Locale — et Boucles de Mémoire Auto-Renforçantes dans les Agents IA pour la raison pour laquelle les valeurs par défaut d’écriture conservatrices importent en premier lieu.
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, sa mémoire, ses sessions, ses compétences, ses 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 Assistant IA Hermes pour les Configurations de Production Réelles. Lorsque vous êtes prêt à créer ou déboguer les fichiers SKILL.md eux-mêmes — métadonnées YAML, niveaux de divulgation progressive, visibilité conditionnelle et installations hub — utilisez Auteurisation de Compétences Hermes Agent — Structure et Meilleures Pratiques de SKILL.md.
Workflow typique
Si vous traitez Hermes comme un agent que vous conserverez, le workflow commence à ressembler à l’ingénierie de services.
Une ligne de base stable
Une ligne de base qui ne se dégrade pas souvent est :
- Installer et exécuter un premier chat dans la CLI.
- Choisir un fournisseur et un modèle avec
hermes model, puis confirmer les coûts. - Configurer les ensembles d’outils et décider si l’exécution du terminal est locale ou sandboxée.
- Apporter une modification rapide à
SOUL.mduniquement après avoir utilisé les valeurs par défaut pendant un certain temps. Les changements d’identité comptent plus que les gens ne le pensent car c’est le « slot 1 » dans le prompt système.
Utilisation quotidienne qui compose
Hermes a une interface utilisateur en terminal plutôt qu’une interface web, et il est conçu pour les longues sessions avec des commandes slash, des sessions reprenables et une sortie d’outils en streaming. Les drapeaux de shell, sous-commandes et raccourcis slash pour cette session se trouvent dans la feuille de triche CLI Hermes Agent.
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 grand
- 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 de Hermes 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 ce modèle de passerelle en cours d’exécution sur un serveur dédié tout en vous connectant depuis un client de bureau séparé, utilisez Configuration Serveur Headless et Bureau À Distance Hermes Agent.
Pour les files d’attente multi-agents et la planification contrôlée, consultez Kanban dans Hermes Agent pour les Flux de Travail LLM Auto-Hébergés, qui couvre les limites du répartiteur, les chaînes de dépendances et le groupage basé sur cron.
La sécurité pour un bot utilisant des outils est importante. Les documents de la 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 vérifient seulement la couche du 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 principale :
hermes doctorpour des diagnostics interactifshermes statuspour un aperçu rapidehermes dumppour 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 réperticient plusieurs problèmes récurrents et leurs corrections, y compris les problèmes de version Python, uv introuvable, et les problèmes de permissions causés par le mélange des installations sudo et des installations utilisateur.
Si vous rencontrez ces erreurs, les documents fournissent des étapes de correction 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 un piège courant : les clés sont spécifiques au fournisseur.
Pour les problèmes de « modèle introuvable », la FAQ renvoie à l’utilisation de hermes model pour choisir un identifiant valide et montre à la fois les surcharges 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 sur le contexte via la compression ou une session fraîche.
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 vers les causes typiques par backend, y compris Docker qui ne tourne pas et les variables SSH manquantes. Il note également que la repli sur local est une action 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’appairage comme les valeurs par défaut sûres, ce qui signifie que de nombreux incidents « le bot est silencieux » sont en réalité l’autorisation qui fait son travail.
