Hermes Agent : le guide de référence du praticien (2026)

TL;DR : Hermes Agent est un agent d’IA open source auto-améliorant développé par Nous Research. Il fonctionne comme une CLI et comme un gateway de messagerie multiplateforme, conserve sur disque une identité durable et une mémoire persistante, agrège des skills qui s’améliorent à l’usage et fonctionne avec n’importe quel fournisseur LLM compatible OpenAI — Nous Portal, OpenRouter, Anthropic, GitHub Copilot, z.ai, Kimi, MiniMax, DeepSeek, Qwen Cloud, Hugging Face, Google, xAI/SuperGrok ou votre propre endpoint auto-hébergé.¹²¹⁹ La version actuelle est la v0.21.5 (tag v2026.9.24, 24 septembre 2026), un correctif cumulatif de la branche v0.21 ; la section Nouveautés de la v0.21.5 présente les changements, puis les sections consacrées aux versions les répertorient de la plus récente à la plus ancienne.⁵² Pour la plupart des nouveaux utilisateurs, la principale difficulté concerne l’authentification auprès des fournisseurs : avec le tag v2026.9.24, Hermes propose 39 fournisseurs dans sa liste de sélection statique et l’étend automatiquement à partir de 38 plugins de fournisseurs intégrés, auxquels s’ajoutent les endpoints personnalisés et trois parcours d’authentification distincts (clé API dans .env, OAuth via hermes model ou endpoint personnalisé dans config.yaml).⁵³ Le modèle d’authentification est la première chose à maîtriser : tout le reste dépend du fournisseur résolu.

Hermes Agent fonctionne comme un environnement d’exécution d’agent complet, et non comme une simple surcouche de chat. Il lit votre système de fichiers, exécute des commandes dans des backends sandboxés, extrait des données du Web, lance des sous-agents, exécute des tâches cron planifiées, communique avec Telegram/Discord/Slack/WhatsApp/Signal/Email depuis un seul processus gateway et crée ses propres skills à partir de son expérience.¹ La CLI est une interface de terminal construite sur une boucle de conversation dans run_agent.py ; le gateway est un processus de longue durée qui transmet les messages des plateformes de messagerie à cette même boucle de conversation.³

La différence entre une utilisation occasionnelle et experte de Hermes repose sur cinq systèmes. Maîtrisez-les et Hermes deviendra un puissant multiplicateur d’efficacité :

1. Résolution du fournisseur : comment les flux d’authentification sont associés aux appels API
2. Hiérarchie de configuration : config.yaml + .env + auth.json + SOUL.md + AGENTS.md
3. Système de tools et de toolsets : ce que l’agent peut faire, avec des autorisations propres à chaque plateforme
4. Système de skills : la mémoire procédurale que l’agent crée et fait évoluer
5. Gateway + cron + profiles : exécuter Hermes là où vous vivez, et pas seulement là où vous vous trouvez

Points clés

• L’authentification auprès des fournisseurs suit trois parcours, pas un seul. Clé API dans .env, OAuth via hermes model/hermes auth ou endpoint personnalisé dans config.yaml. Choisissez le parcours adapté à votre fournisseur, pas celui qui vous semble le plus familier.
• Une seule commande suffit pour changer de fournisseur. hermes model vous guide de manière interactive parmi tous les fournisseurs pris en charge, y compris les connexions OAuth, tandis que /model provider:model permet de changer de modèle en cours de session sans perdre l’historique.²
• Deux fichiers constituent l’interface de configuration modifiable par l’utilisateur. ~/.hermes/config.yaml contient les paramètres et ~/.hermes/.env les secrets. auth.json, SOUL.md, MEMORY.md et skills/ sont gérés directement par Hermes : vous pouvez modifier SOUL.md manuellement, mais l’agent lui-même intervient sur le reste.⁴
• Hermes succède à OpenClaw. Si vous effectuez une migration, hermes claw migrate importe automatiquement plus de 30 catégories d’état.⁵
• Par défaut, les tâches auxiliaires utilisent votre modèle principal. La vision, la classification des approbations, la compression et les titres de session s’exécutent sous forme d’appels LLM « auxiliary » distincts et, avec ce tag, auto les dirige tous vers votre modèle de chat principal — aucune configuration n’est nécessaire, mais avec les modèles de raisonnement coûteux, ces tâches annexes augmentent sensiblement les coûts. Lorsque cela compte, affectez à chaque emplacement auxiliary.<task> un modèle rapide et peu coûteux.⁴³⁴

Chaque section ci-dessous s’appuie sur la documentation en amont disponible sur hermes-agent.nousresearch.com/docs et sur l’arborescence des sources à l’adresse github.com/NousResearch/hermes-agent. Chaque affirmation factuelle comporte une note de bas de page renvoyant vers la page précise en amont dont elle est issue.

Choisissez votre parcours

Fonctionnement de Hermes : le modèle mental

Hermes s’articule autour d’une boucle de conversation unique que chaque point d’entrée peut invoquer. Ces points d’entrée sont la CLI (cli.py), le gateway de messagerie (gateway/run.py), l’adaptateur ACP pour l’intégration aux éditeurs, l’exécuteur de traitements par lots et un serveur API.³ Tous finissent par appeler AIAgent.run_conversation() dans run_agent.py, qui :

1. Construit le prompt système à partir de SOUL.md, MEMORY.md, USER.md, des skills, des fichiers de contexte et des instructions relatives aux outils via agent/prompt_builder.py (la réorganisation de septembre 2026 l’a déplacé dans le nouveau package agent/)³
2. Détermine le fournisseur d’exécution via runtime_provider.py — c’est à cette étape que sont sélectionnés votre mode d’authentification, l’URL de base et le mode API³
3. Appelle le fournisseur à l’aide de l’un des trois modes API : chat_completions, codex_responses ou anthropic_messages³
4. Achemine tous les appels d’outils renvoyés via model_tools.py et le registre central des outils (tools/registry.py)³
5. Répète la boucle jusqu’à ce que le modèle produise une réponse finale, puis enregistre la session dans SQLite avec FTS5³

Il est essentiel de comprendre cette boucle, car chaque fonctionnalité — personnalités, mémoire, skills, compression, solution de repli — se rattache à l’une de ces étapes. Lorsque vous examinez une clé de configuration et vous demandez à quoi elle sert, la réponse est généralement : « C’est un réglage de l’étape 1, 2, 3 ou 4 de la boucle ci-dessus. »

Un cœur indépendant de la plateforme. Une seule classe AIAgent dessert la CLI, le gateway, ACP, l’exécution par lots et le serveur API. Les différences propres aux plateformes résident dans le point d’entrée, et non dans l’agent lui-même.³ C’est pourquoi les mêmes commandes slash fonctionnent dans le terminal et dans Telegram — elles sont acheminées depuis un COMMAND_REGISTRY partagé dans hermes_cli/commands.py.⁶

La structure des dossiers constitue le système. Hermes stocke tout sous ~/.hermes/ (ou $HERMES_HOME pour les profiles autres que celui par défaut) :⁴

~/.hermes/
├── config.yaml        # Settings (model, terminal, TTS, compression, etc.)
├── .env               # API keys and secrets
├── auth.json          # OAuth provider credentials (Nous Portal, Codex, Anthropic)
├── SOUL.md            # Primary agent identity (slot #1 in system prompt)
├── memories/          # Persistent memory (MEMORY.md, USER.md)
├── skills/            # Bundled + agent-created + hub-installed skills
├── cron/              # Scheduled jobs
├── sessions/          # Gateway session state
└── logs/              # agent.log, gateway.log, errors.log (secrets auto-redacted)

Chaque fichier ci-dessus remplit un rôle précis ; aucun ne fait double emploi. Si vous cherchez où Hermes stocke un élément donné, il se trouve dans l’un d’eux.

Nouveautés de la v0.21.5 (récapitulatif du 24 septembre)

Hermes Agent v0.21.5 (tag v2026.9.24, 24 septembre 2026) est la version actuelle, la troisième mise à jour cumulative légère de la branche v0.21.x : « Ce tag regroupe dans une version stable destinée aux utilisateurs en aval les quelque 460 PR fusionnées depuis la v0.21.4. » Les notes éditorialisées sont une nouvelle fois reportées à la v0.22.0. Voici les changements destinés aux opérateurs, vérifiés dans le code source au niveau de ce tag :⁵²⁵³

• La mémoire Hindsight quitte l’arborescence principale. Le fournisseur Hindsight intégré et l’extra pip hermes-agent[hindsight] ont été supprimés ; Hindsight s’installe désormais depuis le catalogue de plugins et est maintenu par Vectorize ; les notes de version ne le mentionnent pas. Si votre configuration définit memory.provider: hindsight, hermes update installe le plugin du catalogue dans le répertoire d’accueil de chaque profile qui le référence. S’il manque encore, le premier démarrage de l’agent l’installe, sauf si security.allow_lazy_installs vaut false (dans ce cas, exécutez hermes plugins install hindsight). Les paramètres, les clés .env et les données de mémoire restent intacts. Consultez Fournisseurs de mémoire externes.
• gateway.multiplex_profiles: false n’est plus pris en charge. Le gateway le remplace directement par true et affiche une seule fois un avis encadré. Un profile nommé qui doit conserver son propre gateway définit gateway.standalone: true dans son fichier config.yaml ; pour mettre hors ligne un profile desservi sans arrêter l’hôte, hermes -p <name> gateway stop le place désormais en attente. Consultez Gateway de messagerie.
• Nouveaux modèles dans les sélecteurs Nous et OpenRouter : GPT-6 Sol et GPT-6 Luna (chacun avec une variante -pro), ainsi que Claude Opus 5.5.
• La compatibilité des plugins reste inchangée : plugins.allow_deprecated_imports: true fonctionne toujours.

Mise à jour : hermes update ou la commande d’installation en une ligne ; les images Docker et Hermes Cloud sont construites à partir de nousresearch/hermes-agent:v2026.9.24.⁵²

Nouveautés de la v0.21.4 (le deuxième correctif cumulatif)

Hermes Agent v0.21.4 (tag v2026.9.21, 21 septembre 2026) est le deuxième correctif cumulatif délibérément léger de la branche v0.21.x. Selon sa propre présentation : « Version corrective. Ce tag regroupe les quelque 1 800 PR fusionnées depuis la v0.21.3 dans une version stable et balisée destinée aux consommateurs en aval (images Docker, Hermes Cloud, déploiements hébergés). » La période écoulée depuis la v0.21.3 compte « 5 071 commits hors fusion » répartis dans « 5 169 fichiers modifiés », ainsi que « 1 812 PR fusionnées » et « 2 116 tickets fermés ». Par nombre de commits, il s’agit du deuxième plus grand intervalle entre deux tags de l’histoire du projet, derrière les 5 139 commits de la v0.21.1 ; par nombre de PR fusionnées, c’est le plus grand. Le récit éditorial est de nouveau reporté, dans les termes exacts suivants : « Les notes de version éditorialisées complètes couvrant cette période seront publiées avec la v0.22.0, qui documentera tout depuis la v0.21.0 » et « Rien de cette période n’est omis. » La note énumère toutefois ce qu’elle ne documente pas, et chaque élément ci-dessous a été vérifié dans le code source au niveau du tag ; lorsqu’un élément modifie une section existante de ce guide, le lien figure directement dans le texte.⁵⁰⁵¹

• Un gateway par hôte, et Desktop s’y rattache au lieu d’en relancer un. La règle est la suivante : un seul hermes serve et un seul hermes gateway run par hôte et par utilisateur du système d’exploitation, chacun multiplexant tous les profile. Elle est appliquée par une nouvelle couche singleton à l’échelle de l’hôte : un verrou d’hôte conservé pendant toute la durée de vie du processus gagnant, ainsi qu’un enregistrement de rendez-vous contenant (pid, createTime). Une deuxième invocation peut ainsi prouver que le propriétaire est bien le même processus toujours actif et s’y rattacher au lieu d’occuper un deuxième port. L’obsolescence est prouvée, jamais supposée, et l’application Desktop applique le même principe de son côté en se rattachant au backend déjà actif sur l’hôte plutôt que d’en lancer un deuxième. La section Gateway de messagerie détaille ce mécanisme.⁵¹
• Les connecteurs deviennent une opération unique gérée par le backend, avec une seule carte de configuration. Un appel à l’outil manage_connections pilote sur le backend une machine à états de connexion reposant uniquement sur les données, tandis que Desktop, TUI et CLI l’affichent tous sous la forme de la même carte de configuration : un champ par identifiant manquant, le bouton d’action de la carte restant désactivé tant que tous les champs obligatoires ne contiennent pas de texte. Consultez la sous-section sur l’offre gratuite de Nous.⁵¹
• --format stream-json : des exécutions ponctuelles lisibles par une machine. hermes chat -q ... --format stream-json émet un objet JSON par ligne de stdout pour les exécuteurs de CI et les orchestrateurs : un événement system/init, puis des deltas text / événements tool_use / tool_result, et enfin une enveloppe terminale result contenant le code de sortie, le texte final et les statistiques de tokens. Les diagnostics et l’identifiant de session restent sur stderr, la sortie des outils est limitée à 5 000 caractères par événement, l’option implique --quiet, exige -q ou --query-file (code de sortie 2 en leur absence) et ne peut pas être combinée avec --tui. Le tableau des options de hermes chat inclut cette option.⁵¹
• skills.auto_load épingle des skills dans chaque session. Les noms répertoriés sous skills.auto_load dans config.yaml sont chargés intégralement dans chaque nouvelle session — CLI, TUI, gateway, cron et API de la même manière — et résolus une seule fois lors de la construction initiale du prompt. Une sous-section consacrée aux skills épinglés est ajoutée au système de skills.⁵¹
• Une option decline pour les messages privés non autorisés. unauthorized_dm_behavior accepte désormais une troisième valeur en plus de pair et ignore : decline envoie un refus poli, puis ne répond plus à cet expéditeur pendant 24 heures. Consultez la section Autorisation et appairage des utilisateurs.⁵¹
• mcp.discovery_concurrency limite les connexions de découverte MCP. La valeur par défaut est 4, tandis que 0 signifie « illimité » ; chaque serveur configuré se connecte toujours, mais ils ne le font plus tous simultanément. Consultez la section Intégration MCP.⁵¹
• session_search prend en charge les bornes temporelles et une nouvelle tentative de rappel. Le schéma de découverte accepte des bornes after/before (au format ISO ou sous forme de durées relatives telles que 7d) et, lorsqu’une requête de plusieurs mots ne renvoie aucun résultat, une nouvelle tentative recherche N’IMPORTE LEQUEL des termes au lieu d’appliquer le ET implicite de FTS5 à tous les termes. Consultez la section Recherche dans les sessions.⁵¹
• hermes sessions set-journal-mode delete|wal : le convertisseur de journal hors ligne. Il s’agit de la procédure en libre-service pour un fichier state.db bloqué dans le mauvais mode de journal SQLite — auparavant, il fallait exécuter manuellement PRAGMA journal_mode=DELETE. Arrêtez d’abord le gateway, le dashboard et chaque CLI : la commande refuse de s’exécuter tant qu’un processus étranger détient la base de données, effectue le basculement sans attendre la fermeture des processus qui l’ont ouverte, puis vérifie les octets d’en-tête SQLite. Windows ne dispose d’aucune analyse des détenteurs ; la commande y refuse donc de s’exécuter jusqu’à ce que vous transmettiez --force, après avoir vous-même arrêté tous les processus Hermes. hermes doctor renvoie désormais vers cette commande. La ligne hermes sessions de la section Commandes de premier niveau l’inclut.⁵¹
• Desktop : un paramètre de police, des mises à jour du moteur en un clic et la désinstallation des plugins. Les paramètres accueillent un champ de famille de polices, conservé séparément pour chaque profile dans desktop.font_family : il remplace la police sans-serif du thème dans le chat et l’interface, la liste de suggestions commence par des polices favorisant l’accessibilité (OpenDyslexic, Atkinson Hyperlegible, Lexend), et une valeur vide laisse le thème décider. Le runtime géré du modèle local affiche un bouton « Mettre à jour le moteur » lorsqu’une mise à jour est disponible ; si celle-ci échoue, le bouton reste visible afin de permettre une nouvelle tentative directe. Enfin, le hub Plugins permet de désinstaller un plugin après confirmation dans une boîte de dialogue.⁵¹
• Catalogues vidéo : LTX 2.5 et Kling O3. Le plugin vidéo FAL ajoute ltx-2.5 (le modèle audio-vidéo open source de Lightricks : audio natif, génération d’une vidéo à partir d’une image jusqu’à 20 s / 4K, préréglages de mouvement de caméra, offre économique — fal refuse les clips de plus de 10 s en 1440p/2160p) et kling-o3 (la gamme de pointe de Kuaishou, en offre premium : narration native à plusieurs plans, audio facultatif, 3 à 15 s).⁵¹
• Le catalogue de plugins devient un répertoire distribué et un site web. Le répertoire plugin-catalog/ du dépôt est passé de 9 entrées dans v2026.9.14 à 228 pour ce tag — un YAML contrôlé par plugin, épinglé sur un SHA de commit précis — et le site de documentation génère désormais une page par plugin et par auteur, chacune affichant le README du plugin depuis le commit épinglé. Les dix plugins communautaires cités dans la version figurent tous dans le catalogue au niveau de ce tag. La section Système de plugins en fournit les détails.⁵¹
• Et une vaste série de correctifs portant sur l’isolation des profile et du multiplexage, cron, kanban, Desktop et state.db, que la version se contente de mentionner comme une catégorie ; il reviendra à la v0.22.0 d’en établir le relevé éditorialisé.⁵⁰

L’annulation de la compatibilité des plugins n’a toujours pas été intégrée durant cette période. COMPAT_MANIFEST.md, compat_manifest.json et les couches de compatibilité sont tous présents dans v2026.9.21 ; les seules modifications apportées à hermes_cli/plugin_compat.py pendant cette période sont un cache d’analyse à l’échelle du processus (un gateway multiplexé découvre les plugins une fois par profile servi, et la nouvelle analyse du code source de chaque plugin ajoutait environ 0,4 s par profile au démarrage) et l’utilisation de chemins de résultats au format POSIX sous Windows (#112576). La condition de date et l’échappatoire par booléen littéral restent inchangées : plugins.allow_deprecated_imports: true permet donc toujours de charger les plugins concernés. L’encadré sur la compatibilité de la section Système de plugins présente l’état actuel.⁴²

La procédure de mise à jour reste inchangée : hermes update (pour les installations git) ou le programme d’installation shell pour les nouvelles installations ; les images Docker et Hermes Cloud sont construites à partir de ce tag (nousresearch/hermes-agent:v2026.9.21).⁵⁰

Nouveautés de la v0.21.3 (le correctif du 14 septembre)

Hermes Agent v0.21.3 (tag v2026.9.14, 14 septembre 2026) couvre trois jours supplémentaires de main dans une note composée de deux éléments. Cette version a été publiée parce que les agents Cloud se mettent automatiquement à jour vers le tag de version le plus récent et que les correctifs de connexion au gateway distant devaient leur parvenir. (1) Les sessions distantes du dashboard ne sont plus révoquées par des rafales d’actualisation : les deux chemins d’actualisation du gateway (le contrôle par cookie et la route bearer native de Desktop) regroupent désormais les requêtes simultanées portant le même token d’actualisation rotatif en une seule opération. Ainsi, une rafale provoquée par la sortie de veille de Desktop ne peut plus rejouer auprès du Portal un token déjà renouvelé, déclencher la détection de réutilisation et révoquer toute la session. L’actualisation s’exécute par ailleurs en dehors de la boucle d’événements, de sorte qu’un fournisseur d’identité lent ne bloque plus /api/status. (2) Les processus de longue durée cessent de créer des handles d’écriture en double pour state.db : les lecteurs du gateway, du backend dashboard/desktop, d’ACP et de CLI se connectent en lecture seule, tandis que les processus d’écriture internes partagent le handle du registre. Statistiques de la période : « 1 036 commits hors fusion » répartis dans « 2 642 fichiers modifiés » et « 338 PR fusionnées ». Tout le reste est délibérément reporté : la version cite ce qu’elle ne documente pas (sélecteurs d’effort de raisonnement dans chaque sélecteur de modèle, PKCE OAuth d’OpenRouter, décodage HEIF/HEIC/AVIF, vague d’ajouts au catalogue FAL, tableaux collés dans Slack et API des sessions d’agents, refus du mode WAL de state.db sur les systèmes de fichiers inter-VM, entre autres) et s’engage à en fournir un relevé éditorialisé, dans les termes exacts suivants : « Les notes de version éditorialisées complètes couvrant cette période seront publiées avec la v0.22.0, qui documentera tout depuis la v0.21.0 » et « Rien de cette période n’est omis. »⁴⁹

Et l’échéance de compatibilité des plugins est arrivée comme prévu. La suppression annoncée pour le 14 septembre 2026 par la v0.21.1 a pris effet sous la forme d’une condition de date dans le code distribué, et non d’une annulation dans le code : au niveau du tag v2026.9.14, hermes_cli/plugin_compat.py contient COMPAT_REMOVAL_DATE = 2026-09-14, et removal_in_effect() renvoie true à partir de cette date (ou dès que le fichier manifeste disparaît). Tout plugin externe concerné est donc désormais désactivé au chargement, avec l’avertissement rouge. Ce qui ne s’est PAS encore produit : l’annulation qui supprime réellement les anciens chemins d’importation. COMPAT_MANIFEST.md, compat_manifest.json et les couches de compatibilité sont encore tous présents au niveau du tag — ainsi que dans v2026.9.21 et sur main au 22 septembre — ce qui explique pourquoi plugins.allow_deprecated_imports: true fonctionne toujours comme échappatoire : les anciens chemins continuent d’être résolus dès lors que le chargeur est autorisé à poursuivre. Deux pièges : la clé doit être un booléen YAML littéral (le code n’accepte que le booléen True ; une chaîne entre guillemets telle que "true" ou "false" est considérée comme absente, conformément au commentaire du code « Literal boolean only »), et cette échappatoire disparaîtra dès l’intégration de l’annulation, puisque les chemins eux-mêmes n’existeront plus. L’encadré sur la compatibilité de la section Système de plugins présente l’état actuel.⁴²⁴⁹

Nouveautés de la v0.21.2 (la version corrective de state.db)

Hermes Agent v0.21.2 (tag v2026.9.11, 11 septembre 2026) vise avant tout à réparer ce que la v0.21.0 avait cassé. Les notes de version le disent sans détour : « La v0.21.0 comportait une refonte majeure de la gestion des connexions au stockage des sessions qui, sur certaines installations, a fragilisé state.db : des processus d’écriture secondaires annulaient mutuellement leurs verrous, des bases de données saines étaient signalées comme corrompues et une seule ligne défectueuse suffisait à faire échouer sessions list. Cette version élimine cette catégorie de problèmes et regroupe tout ce qui a rejoint main au cours des quatre jours suivant la v0.21.1. » Contrairement aux notes volontairement succinctes de la v0.21.1, celles-ci présentent leurs propres points forts ; les statistiques de cette période font état de « 947 commits hors fusion », répartis sur « 1 869 fichiers modifiés », et de « 312 PR fusionnées » provenant de « 140 contributeurs ». Quant au bilan éditorial de toute la série v0.21.x, il reviendra toujours à la v0.22.0.⁴⁸

• La campagne de fiabilisation de state.db : six PR et 44 problèmes résolus. Les recommandations destinées aux opérateurs figurent en premier dans les notes de version, et vous devriez également les suivre : si votre state.db a été endommagé sous la version 0.21.0 ou 0.21.1, exécutez hermes doctor — l’outil distingue désormais les dommages structurels de ceux affectant l’index de recherche en texte intégral, au lieu de tout qualifier de « corruption d’écriture FTS ». Il vous oriente aussi vers hermes sessions recover --inspect-only (hors ligne, non destructif et rattaché au profile ; cette commande vérifie la lisibilité des tables canoniques sans créer de base de données de sortie) lorsqu’une reconstruction ne suffit pas. La correction des causes profondes élimine tous les processus d’écriture secondaires du stockage : les gateways de profile écrivaient toutes les 5 secondes l’état des salons hébergés dans le state.db racine. Cette coordination réside désormais dans un fichier shared-state.db dédié, de sorte que les gateways de profile n’ouvrent jamais le stockage principal des sessions en écriture ; le dashboard tente d’abord une ouverture en lecture seule ; la protection du cycle de vie de cron passe par le registre des connexions suivies plutôt que par un appel brut à open() sur une base de données active (qui annulait les verrous POSIX du gateway — la recette classique pour corrompre SQLite) ; enfin, doctor --fix refuse tout checkpoint dont il ne peut garantir la sûreté. Au-delà des processus d’écriture : les dommages affectant l’index FTS dégradent désormais la recherche, puis entraînent une reconstruction ultérieure de l’index, au lieu de bloquer entièrement l’échange ; une ligne corrompue ne fait plus échouer sessions list, l’exportation ou les insights (les lignes défectueuses affichent ?, accompagné d’un avertissement indiquant la session concernée) ; les sessions ne se lient jamais à la base de données d’un autre profile et ne la consultent jamais ; enfin, une ouverture en lecture seule ne prend plus le verrou d’écriture, si bien qu’une exécution ponctuelle de hermes derrière un gateway très sollicité est passée d’un blocage suivi d’un échec après 4 à 20 s à 0,01 s.⁴⁸
• Renforcement de l’isolation entre plusieurs profiles. Depuis la v0.19.0, ce guide reprend l’affirmation du projet selon laquelle le routage par profile offre à chacun « une configuration, des skills, une mémoire et des secrets totalement isolés ». En v0.21.2, cette promesse comportait encore des failles, désormais corrigées : les bots des profiles secondaires héritaient des listes d’autorisation du profile par défaut, les adaptateurs pouvaient envoyer des identifiants à l’hôte du profile par défaut, les serveurs MCP via stdio recevaient les secrets du coffre-fort du profile par défaut, la livraison MEDIA: pouvait joindre le fichier .env, auth.json ou state.db d’un autre profile, les callbacks des webhooks et de Feishu pouvaient s’écarter du profile routé, et les profiles secondaires pouvaient récupérer le jeton Nous bearer d’un profile voisin dans les mémos propres au processus (#107609-#107630). Si vous exécutez plusieurs profiles sous un même gateway multiplexé, c’est dans cette version que la promesse d’isolation devient réellement effective.⁴⁸
• Le coffre-fort d’identifiants qui dissimule les mots de passe. L’agent peut désormais se connecter, payer et renseigner des adresses dans le navigateur à partir de 1Password, Bitwarden ou du coffre-fort local de Hermes sans jamais voir aucun secret. Les codes d’authentification à deux facteurs proviennent d’une clé d’authentification enregistrée (TOTP : une graine en base32 ou un URI otpauth://totp ; le protocole HOTP fondé sur un compteur est refusé) ou sont demandés dans votre interface utilisateur. Chaque backend transmet à l’agent la même structure — les métadonnées de connexion accompagnées d’un identifiant opaque associé à un espace de noms (vault_ en local, op:, bw:), le mot de passe n’étant récupéré qu’au moment de remplir le champ ; les gestionnaires externes restent verrouillés jusqu’à ce que vous les déverrouilliez pour la session, et le mot de passe principal « n’est jamais un argument d’outil, n’apparaît jamais dans argv et n’est jamais conservé ». Cette fonctionnalité s’appuie sur le travail effectué autour de SecretSource dans la v0.19.0, qui avait retiré les clés API des providers du fichier .env en texte brut ; le coffre-fort en fait maintenant autant pour les identifiants de navigation de l’agent.⁴⁸
• Un catalogue de plugins sélectionnés et épinglés par SHA. hermes plugins browse répertorie « toutes les entrées sélectionnées du catalogue de plugins », hermes plugins search interroge le catalogue et hermes plugins install accepte les noms du catalogue en plus des URL Git et des références owner/repo. hermes plugins pack complète l’ensemble avec des « ensembles de plugins déclaratifs et partageables » : un fichier hermes-pack.yaml unique épingle un ensemble de plugins sur des SHA de commit précis, pack install les déploie sous forme d’installations épinglées ordinaires tout en maintenant le consentement aux capacités séparément pour chaque plugin, pack export génère un pack à partir de l’installation actuelle et pack show permet d’en effectuer une simulation. Le bloc de commandes de la section Système de plugins contient les nouvelles sous-commandes.⁴⁸
• Offre gratuite de Nous et premier lancement guidé. Les nouvelles installations bénéficient immédiatement d’une inférence et de connecteurs gratuits, avec une seule commande pour se connecter ; /login fonctionne depuis une conversation et les outils des connecteurs (Gmail, Linear, Notion et les autres) sont accessibles par recherche au moyen de tool_search. Le premier lancement guidé de l’application de bureau est conditionné par HERMES_GUEST_ONBOARDING=1, et seule la valeur littérale 1 l’active : le propre test de l’application vérifie que 'true', '0' et une valeur vide le laissent tous désactivé. La décision prise au lancement est inscrite dans l’environnement du backend démarré afin qu’une valeur héritée ne puisse jamais s’y propager. Consultez Nous Tool Gateway.⁴⁸
• Fin des démarrages en rafale du backend de l’application de bureau. Bot Mode lançait auparavant un backend ou établissait une connexion avec celui-ci pour chaque profile au démarrage et à chaque actualisation de la liste ; survoler la liste des bots lançait un backend pour chaque ligne, et un changement de profile pouvait démarrer un doublon du backend principal. Tous ces problèmes ont été corrigés dans cette version.⁴⁸

La procédure de mise à jour reste inchangée : hermes update depuis une installation existante, ou le programme d’installation shell pour une nouvelle installation.⁴⁸

Nouveautés de la v0.21.1 (le patch récapitulatif)

Hermes Agent v0.21.1 (tag v2026.9.7, 7 septembre 2026) est volontairement succincte : une « version corrective » qui « regroupe l’état actuel de la branche main depuis la v0.21.0 pour les déploiements basés sur des tags et les utilisateurs en aval ». Le corps du texte fournit les statistiques de la période — « 5 139 commits hors fusion dans 4 364 fichiers modifiés (+601 014 / -768 419) » et « 632 PR fusionnées » — puis reporte la suite du récit : « Les notes de version complètes et organisées pour cette période seront publiées avec la v0.22.0. » Il s’agit donc de la plus grande période jamais couverte entre deux tags dans l’histoire du projet (aucune période antérieure entre tags adjacents ne dépasse les 2 790 commits hors fusion de v2026.7.20..v2026.7.30), publiée avec les notes de version les plus courtes. En attendant que la v0.22.0 en fournisse le compte rendu organisé, les six ensembles ci-dessous regroupent les changements qui influent sur votre utilisation de Hermes avec ce tag, chacun ayant été vérifié dans le code source.⁴¹

• Le code source a été décomposé, et le délai de compatibilité des plugins a expiré le 14 septembre. La décomposition de septembre 2026 (PR #102117) a scindé les grands modules du dépôt en fichiers spécialisés : un nouveau package agent/ contient les composants internes de la boucle de conversation (214 modules de premier niveau, auxquels s’ajoutent sept sous-packages ; prompt_builder.py se trouve désormais dans agent/prompt_builder.py, tandis que run_agent.py reste le fichier d’origine de AIAgent), les analyseurs des sous-commandes de CLI ont été déplacés dans un package hermes_cli/subcommands/ (61 modules), la liste statique CANONICAL_PROVIDERS a été déplacée de hermes_cli/models.py vers hermes_cli/models_catalog_static.py (la liste elle-même reste inchangée : 39 entrées statiques, toujours complétées automatiquement à partir des 39 dossiers de plugins de fournisseurs inclus), et delegate_task a été réparti dans une douzaine de modules tools/delegate_tool_*. Les chemins d’importation internes ne constituent pas une API stable ; un nouveau fichier COMPAT_MANIFEST.md à la racine du dépôt réexporte donc 1 148 noms publics « moved-lazy » depuis leurs anciens chemins de module, chacun émettant un HermesPluginCompatWarning une fois par nom et par processus lors de sa résolution. Cette couche de compatibilité était temporaire, et sa suppression a pris effet comme prévu le 14 septembre 2026, six jours après le tag — non pas sous la forme d’un rétablissement du code, mais au moyen d’une condition de date déjà intégrée au code publié. Depuis cette date, tout plugin tiers concerné n’est pas chargé : la bannière de CLI, hermes doctor et hermes update affichent un avertissement rouge qui nomme le plugin désactivé, l’application de bureau affiche une fenêtre modale unique et hermes plugins list indique le motif. Si vous utilisez des plugins externes, vérifiez-les : hermes plugins compat <path> affiche chaque occurrence sous la forme file:line, avec l’ancien chemin -> le nouveau chemin, et renvoie le code de sortie 1 tant qu’il en reste (--json produit une sortie exploitable par une machine ; exécutez la commande sans argument pour analyser l’ensemble des plugins installés). La solution de secours pour un plugin dont l’auteur n’a pas encore effectué la migration consiste à définir plugins.allow_deprecated_imports: true dans config.yaml, et elle fonctionne toujours : le changement qui supprime réellement les anciens chemins d’importation n’a toujours pas été intégré au 22 septembre (vérification effectuée jusqu’au tag v2026.9.21 et sur main) ; les anciens chemins continuent donc d’être résolus dès que le chargeur est autorisé à poursuivre. Les détails sur les conséquences figurent dans la section Nouveautés de la v0.21.2 ci-dessus ; la section Système de plugins contient l’encadré sur l’état actuel.⁴²
• Les conversations du gateway ne sont désormais plus renouvelées par des minuteurs, quelles que soient les circonstances. La documentation sur le cycle de vie des sessions énonce désormais explicitement le contrat : « L’inactivité et le temps écoulé ne provoquent jamais le renouvellement d’une conversation. /new et /reset créent une limite explicite ; la compression du contexte continue de gérer les historiques longs. L’ancienne configuration des minuteurs est ignorée. Le type de données SessionResetPolicy existant est une donnée de compatibilité inerte, et non une politique appliquée à l’exécution. » Les limites sont explicites et définies par l’utilisateur ; si vous avez conservé des minuteurs de réinitialisation de session datant d’OpenClaw lors d’une migration avec hermes claw migrate, ils constituent désormais des données inertes. Consultez la section Gateway de messagerie.⁴³
• L’autorisation MCP bénéficie désormais d’un flux par code d’appareil. hermes mcp login <name> accepte à présent --flow {browser,device} : browser correspond au flux PKCE existant, device à une connexion par code d’appareil conforme à la RFC 8628 pour les machines sur lesquelles un rappel de navigateur n’est pas pratique, et cette option remplace la configuration oauth.flow du serveur. Cette période a également renforcé le reste de la surface d’authentification MCP : la propriété du profile est appliquée dans toutes les sessions OAuth, les caches de métadonnées OAuth mal formés sont ignorés au lieu de bloquer un serveur, et l’application de bureau relaie l’OAuth de MCP par l’intermédiaire de rappels locaux au client. Autre changement connexe : -t/--toolsets filtre désormais également les serveurs MCP configurés qui sont effectivement lancés ; une exécution ponctuelle de hermes -z -t <toolsets> évite donc le démarrage à froid des serveurs dont elle n’a pas besoin. Le bloc de commandes de la section Intégration MCP inclut maintenant login et reauth [--all], deux commandes antérieures à cette période, mais qui n’avaient pas encore été documentées ici.⁴⁴
• La délégation décrit désormais honnêtement le travail en arrière-plan. Six changements améliorent la fiabilité de delegate_task, tous relevés dans le code source de l’outil de délégation au niveau du tag. (1) Par défaut, un lot en arrière-plan renvoie UNE seule notification d’achèvement ; l’activation de delegation.independent_completions divise l’appel en unités d’achèvement : les tâches partageant une même valeur group sont réunies et signalées ensemble, tandis que chaque tâche non groupée est signalée individuellement à mesure qu’elle se termine. Ce comportement par défaut est intentionnel — le code source précise qu’une avalanche de notifications par tâche « fragmentait les orchestrateurs qui n’avaient rien prévu pour les gérer ». (2) Les processus en arrière-plan d’un enfant sont arrêtés lors de sa fermeture, sauf si l’enfant les transmet au parent avec process_manage(action="handoff") ; les processus restants non transmis sont nommés dans le résultat sous orphaned_processes, tandis que les processus enfants terminés sans que leur sortie ait jamais été lue apparaissent sous unread_completions, accompagnés de la fin de leur sortie. Selon la docstring du code source, le principe retenu est que le parent « doit l’apprendre de l’environnement d’exécution », plutôt que de se fier à l’affirmation « watcher running » d’un enfant. (3) delegation.fallback_providers devient une véritable option de configuration : null hérite de la chaîne du parent pour les enfants non épinglés, [] désactive le fallback, et un enfant épinglé par fournisseur, endpoint ou modèle ne bénéficie d’aucun fallback, sauf si ce paramètre en déclare un. (4) La chaîne de fallback de l’enfant est résolue au moyen du normaliseur canonique ; les entrées mal formées sont donc supprimées au lieu d’empêcher un lancement. (5) Un plantage au milieu d’une unité ne fait plus perdre les enfants ayant terminé : chaque enfant achevé d’une unité qui en comporte plusieurs est enregistré durablement sur la propre ligne de l’unité et reste présent dans le résultat récupéré en tant que résultat partiel. (6) Les subagents n’héritent jamais du niveau de cache des prompts d’une heure : un enfant délégué est ramené au niveau de 5 minutes, car le niveau d’une heure est tarifé pour une personne qui s’absente, et non pour une vague d’enfants exécutés en parallèle.⁴⁵
• Fournisseurs et modèles. Les catalogues accueillent GPT-6 Astra et Astra Pro d’OpenAI, avec les variantes de niveau de vitesse -fast/-flex (« prix multiplié par 2, niveau prioritaire » / « prix multiplié par 0,5, niveau flexible ») dans les catalogues Nous Portal et OpenRouter. Sur la route OAuth de ChatGPT/Codex, Astra est réservé selon le compte (seule la découverte en direct propre au compte peut l’annoncer) et bénéficie d’une variante facultative -900k dans le sélecteur, qui fait passer la fenêtre annoncée de 272K à environ 900K, valeur vérifiée en conditions réelles ; le suffixe n’est jamais transmis au serveur. S’y ajoutent : anthropic/claude-fable-5.1, google/gemini-3.7-flash et gemini-3.8-flash, qwen/qwen3.8-max-0902 et qwen3.8-flash, ainsi que la famille Muse Spark 1.3 de Meta (contexte de 1M, variantes de contributeurs incluses), accompagnée d’un plugin de fournisseur Meta muse-image pour la génération d’images. Tavily fait son apparition comme backend de recherche et d’extraction web (TAVILY_API_KEY ; le fonctionnement sans clé est possible lorsque Tavily est sélectionné via hermes tools). Un environnement d’exécution llama.cpp géré fait des modèles locaux une voie de premier ordre (binaires officiels, un seul llama-server supervisé, configuration en un clic depuis l’application de bureau), tandis que les fournisseurs de processus externes hors arborescence disposent de leur propre branche de résolution. Sur le plan opérationnel : les catalogues distants du sélecteur sont désormais actualisés toutes les 20 minutes (model_catalog.ttl_minutes, valeur par défaut : 20 ; l’ancienne clé ttl_hours n’est prise en compte que lorsqu’un utilisateur l’a explicitement définie).⁴⁶
• Application de bureau : annotez la page, contrôlez la session. Le navigateur intégré propose désormais un mode de commentaire : cliquez sur Annotate, puis sur n’importe quel élément de la page active (ou tracez une zone) et saisissez une note ; les commentaires enregistrés restent visibles sous forme de repères numérotés et n’envoient jamais de tour de conversation par eux-mêmes. Lorsque vous avez terminé, « Add N comments » transfère le lot vers l’éditeur, avec une capture d’écran recadrée pour chaque repère ; chaque commentaire associé à un élément comprend son sélecteur CSS, son balisage et les styles calculés pertinents pour la mise en page, afin que l’agent retrouve l’élément dans votre code source au lieu de le deviner à partir d’une image (les mots de passe, les valeurs masquées et les attributs évoquant des clés sont expurgés avant que le balisage ne quitte la page). Les lots plus volumineux sont regroupés par zone de la page : une vingtaine de commentaires deviennent ainsi quelques unités de travail qui touchent généralement des fichiers distincts — ce qui permet de les distribuer sans risque à des workers parallèles. Autour de cette fonctionnalité s’ajoutent : des commandes de session structurées, des commandes d’automatisation des sessions, la création de sessions par glisser-déposer, une vue d’importation de sessions pour les transcriptions provenant d’agents de programmation tiers, display.resume_last_session (valeur par défaut : true ; un démarrage à froid rouvre la dernière conversation ou page), une demande de consentement lors de la première ouverture proposant browser.use_real_profile lorsqu’un panneau Browser s’ouvre alors que cette option est désactivée, un catalogue intégré de skills facultatifs sous Capabilities -> Skills avec installation en un clic, ainsi qu’une nouvelle interface de bureau en russe (les 17 catalogues de langues de CLI restent inchangés).⁴⁷

La procédure de mise à jour reste inchangée : exécutez hermes update depuis une installation existante, ou utilisez le programme d’installation shell pour une nouvelle installation. Il reviendra à la v0.22.0 de fournir le compte rendu organisé de cette période ; les ensembles ci-dessus regroupent les changements applicables au niveau de ce tag.⁴¹

Nouveautés de la v0.21.0 (The Pantheon Release)

Hermes Agent v0.21.0 (tag v2026.8.31, 31 août 2026) est la version actuelle regroupant les nouvelles fonctionnalités et constitue le récapitulatif de référence vers lequel toute la série v0.20.x renvoyait jusqu’ici : « Cette version rassemble tous les correctifs d’infrastructure des tags v0.20.1 à v0.20.6 ; ces étapes sont désormais intégralement documentées ici. » Elle s’inscrit dans la continuité de The Herald : « La v0.20.0 a fait de Hermes le héraut : il parlait et transmettait les messages aux autres agents. Dans la v0.21.0, les dieux se réunissent. » Voici les statistiques exactes : « Depuis la v0.20.0 : environ 5 800 commits · environ 2 475 PR fusionnées · environ 5 680 fichiers modifiés · environ 869 000 insertions · environ 135 000 suppressions · environ 2 100 issues clôturées · plus de 760 contributeurs ».³⁵

La version est organisée par domaine fonctionnel ; ce résumé suit la même structure. Lorsqu’une fonctionnalité modifie une section permanente de ce guide, un lien est fourni directement dans le texte.

• Bot Mode : vos agents forment désormais une société intégrée. Bot Mode, auparavant fourni par le plugin hermes-bots dans la version v0.20.3, devient une composante activée par défaut de l’application de bureau. Chaque profile d’agent reçoit un nom, un visage d’avatar déterministe assorti de commandes de génération aléatoire et de verrouillage, ainsi qu’une place dans une liste partagée ; vous pouvez créer des discussions de groupe dans le style de Discord, où plusieurs bots et vous-même échangez dans un même salon, mentionner n’importe quel bot avec @ depuis la zone de rédaction, puis attribuer un nom et une image aux salons. Le sous-ensemble de fonctionnalités comprend des cartes de messages entre agents indiquant leur auteur, des avis de remise côté expéditeur, une hydratation donnant la priorité à l’affichage pour des réveils instantanés, un volet Routines et une reconstruction fondée sur le système de conception de l’application. Comme l’indique la version elle-même : « Auparavant, le “multi-agent” désignait de la plomberie ; désormais, il ressemble à une application de chat remplie de collègues. »³⁵
• hermes peer : des messages privés de bot à bot entre vos agents. Tout agent Hermes peut envoyer un message à n’importe quel autre agent à l’aide de son identifiant, quels que soient les profiles et gateways, depuis le CLI ou au sein d’une conversation : demandez à votre bot de recherche de transmettre ses résultats à votre bot de programmation, puis consultez sa réponse là où vous vous trouvez. « Les réponses arrivent dans le Bot Chat canonique de chaque agent : les conversations entre agents sont donc durables et consultables, et non envoyées sans suivi. » La commande hermes peer (ajout, affichage et suppression de peers, ainsi que dm) figure dans le tableau des commandes de premier niveau.³⁵
• Des tâches cron qui se souviennent. Les tâches planifiées cessent d’avoir une mémoire de poisson rouge : les agents cron chargent et mettent à jour une mémoire persistante comme tous les autres agents, continuity=true transmet le résultat de chaque exécution à la suivante afin qu’un moniteur puisse éliminer les doublons par rapport à ce qu’il a déjà signalé, chaque tâche bénéficie d’un bloc-notes persistant, les tâches en mode moniteur ignorent entièrement le LLM lorsqu’aucun changement n’est détecté, l’effort de raisonnement peut être fixé pour chaque tâche et le résultat cron peut parvenir au Bot Chat canonique d’un bot, où celui-ci répond réellement. La section Tâches planifiées (Cron) documente désormais le fonctionnement exact de chacun de ces éléments pour ce tag.³⁵³⁷
• Orchestration en direct des subagents. delegate_task se dote d’actions de contrôle : afficher les agents enfants en cours d’exécution, réorienter l’un d’eux à la volée ou l’arrêter prématurément tout en conservant son résultat partiel. Les résultats des agents enfants peuvent être validés par rapport à un schéma JSON, le coût de chaque délégation apparaît dans les résultats et les valeurs par défaut passent à 250 itérations par subagent et 10 agents enfants simultanés (les limites unifiées qui ont remplacé max_async_children dans la v0.19.0).³⁵³⁸
• Le centre de commande MCP. Les serveurs MCP et le catalogue sont réunis sur une même page de l’application de bureau, avec import par glisser-déposer de type « collez n’importe quoi », vérifications d’état en arrière-plan vous invitant à vous réauthentifier avant l’échec d’un appel d’outil, vue superposée des coûts et de l’utilisation de l’ensemble du parc (estimation des tokens de schéma et utilisation sur 30 jours par serveur), ainsi que des liens profonds hermes:// permettant d’installer un serveur MCP après confirmation explicite. Consultez Intégration de MCP.³⁵
• Une vague d’améliorations pour le CLI. Ctrl+P ouvre une palette de commandes avec recherche approximative (également accessible avec /palette), le sélecteur /model filtre les résultats à mesure que vous saisissez du texte, /status affiche le mode de raisonnement, les approbations en attente et l’utilisation du contexte, tandis que la barre d’état peut afficher en temps réel le pourcentage de réussite du cache, la latence et le nombre de tokens par seconde, avec un réglage pour chaque champ. S’y ajoutent un arrêt d’urgence global, l’épinglage et le désépinglage des sessions, des textes indicatifs tournants dans la zone de rédaction et des animaux de compagnie dans le terminal. Précision concernant la nomenclature : la présentation de la version désigne le vérificateur d’approbation en mode simulation par hermes approval-check ; dans ce tag, cette fonctionnalité correspond à hermes approvals test — aucune sous-commande approval-check n’existe.³⁵⁴⁰
• L’agent pilote le navigateur de l’application de bureau. Le navigateur intégré n’est plus une simple fenêtre que l’agent peut uniquement observer : Hermes y navigue, clique et lit directement son contenu, tandis que les pages peuvent être ouvertes dans votre navigateur système avec des menus contextuels complets pour les liens.³⁵
• Six nouveaux fournisseurs et une vague d’enrichissements du catalogue de modèles. Meta Model API (Muse Spark), CommandCode, Tencent TokenPlan, Nebius Token Factory, Ramp Router et Actual Computer. Trois d’entre eux (Meta AI, CommandCode et Actual Computer) avaient été intégrés lors de précédentes étapes de regroupement et figuraient déjà dans la matrice complète des fournisseurs ; la matrice inclut désormais Tencent TokenPlan, Nebius Token Factory et Ramp Router, ainsi que la nouvelle offre Alibaba Token Plan mentionnée dans la documentation. Les catalogues accueillent GLM-5.3-Flash, qwen3.8-max/flash, Gemini 3.7 Flash, MiniMax M3 free, Nemotron 3.5 Lightning et Muse Spark 1.2. Deux évolutions structurelles les accompagnent : model_overrides dans config.yaml vous permet de modifier la fenêtre de contexte ou la tarification de n’importe quel modèle sans attendre une nouvelle version, et les fournisseurs peuvent désormais être distribués sous forme de paquets installés avec pip et détectés par des points d’entrée ; un registre unifié de garde-fous de sélection avertit également, dans toutes les interfaces de sélection, lorsqu’un modèle s’entraîne sur vos données.³⁵³⁶
• Renforcement généralisé de la sécurité. Toute écriture dans les fichiers protégés d’instructions des agents (AGENTS.md, skills et espaces de stockage de mémoire) nécessite désormais systématiquement une approbation, afin qu’un agent victime d’une injection de prompt ne puisse pas réécrire discrètement ses propres consignes permanentes ; une vaste campagne de masquage comble les failles de divulgation de secrets dans les erreurs du terminal, la lecture des fichiers .env, les checkpoints et les journaux ACP ; le système d’approbation reconnaît désormais les commandes Windows destructrices ; les autorisations macOS persistent après les mises à jour grâce à une identité de signature TCC stable (hermes desktop --setup-tcc-identity) ; enfin, l’entrée Blender du catalogue MCP et son skill ont été supprimés à la suite d’une compromission en amont. Consultez Renforcement de la sécurité pour connaître les détails propres à ce tag.³⁵³⁹
• Maturation du gateway. Slack bénéficie de cartes dynamiques natives (réponses véritablement diffusées en continu, ainsi que cartes de plan et de tâches facultatives) et de la désactivation des aperçus de liens sortants ; Telegram reçoit un sélecteur intégré qui permet de rechercher chaque commande et chaque skill au moyen de @botname, en contournant la limite du menu de commandes de Telegram ; le canal de relais gagne en maturité (initialisation native des plugins, opérations sur les cartes dynamiques avec diffusion continue des brouillons, segmentation par plage de session et restauration de la transcription STT des messages vocaux) ; une socket de contrôle du gateway permet aux consommateurs du parc d’interroger le gateway et aux outils de mise à jour de le suspendre proprement au lieu d’arrêter brutalement toute son arborescence de processus ; enfin, le mécanisme de récupération des tours capture les piles des workers bloqués lorsque le watchdog se déclenche.³⁵
• Une vague de skills. Huit skills de productivité récupérés (document-to-action-items, meeting-action-items, email-inbox-triage, github-issue-to-pr, weekly-review-planning, competitor-news-monitor, product-price-monitor, social-media-content-calendar), des clients API dérivés de HAR (« observez une fois un site web, puis appelez directement son API caché sans navigateur »), publish-site, session-librarian, blocked-page-recovery, merge-reconciler, plan-interrogation, ainsi qu’un linter consultatif pour SKILL.md lors de la création.³⁵

Annulé dans cette série (non livré) : le mode Model Council (/council) et le context engine DCP ont tous deux été intégrés, puis annulés ; le serveur gateway exclusivement WS (#94245) a été fusionné, puis annulé (#96118), de sorte que FastAPI reste sur le chemin de démarrage de l’application de bureau — en revanche, la relecture des événements marqués par un numéro de séquence (#94219) et la reconnexion sans perte de l’application de bureau via WebSocket ONT bien été livrées. Electron est revenu à la version 40.10.2. Si des contenus de la communauté consacrés aux versions v0.20.x mentionnaient l’un de ces éléments, sachez qu’ils ne figurent pas dans cette version.³⁵

La procédure de mise à jour ne change pas : utilisez hermes update depuis une installation existante ou le programme d’installation shell pour une nouvelle installation. La sous-section récapitulative située sous la version The Herald ci-dessous demeure le relevé, tag par tag, des apports de chaque étape.³⁵

Nouveautés de la v0.20.0 (version The Herald)

Hermes Agent v0.20.0 (tag v2026.8.3, 3 août 2026) était la version fonctionnelle précédant le regroupement complet opéré par la v0.21.0 ; les v0.20.1 (13 août) et v0.20.2 (16 août) sont des tags de stabilisation qui s’appuient sur celle-ci, tandis que les v0.20.3 (tag v2026.8.16.2, publiée le 17 août), v0.20.4 (tag v2026.8.18, 18 août), v0.20.5 (tag v2026.8.19, publiée le 21 août) et v0.20.6 (tag v2026.8.27, 27 août) poursuivent cette série de regroupements avec leurs propres lots de fonctionnalités — consultez la sous-section ci-dessous. La période écoulée depuis la v0.19.0 couvre environ 3 650 commits, 1 400 PR fusionnées et 1 200 issues clôturées grâce à plus de 650 contributeurs.⁵⁵

Trois changements rendent obsolètes les instructions données dans les versions précédentes de ce guide. Lisez-les avant toute autre chose :

• Node 26 est désormais requis. Le programme d’installation fixe NODE_VERSION="26" et refuse les environnements d’exécution plus anciens avec le message « Node.js … is too old (Hermes requires Node >=26). » Les programmes d’installation, heal et upgrade appliquent tous cette exigence. Notez que la page d’installation du site de documentation indique encore Node v22 — le script d’installation et les notes de version sont les sources les plus récentes et font autorité.⁵⁵
• pip et Homebrew ont été abandonnés, pas seulement dépréciés. Citation exacte : « brew + pip/PyPI wheel channels retired (shell installer / Docker / Nix are the supported channels). » Si votre installation repose encore sur pip ou brew, ce canal ne reçoit plus aucune version.⁵⁵
• La limite par défaut des itérations d’appel d’outils est passée de 90 à 500. Les longues exécutions autonomes ne se heurtent plus à une barrière artificielle, et tous les seuils de pression budgétaire ci-dessous sont calculés en fonction de ce nouveau plafond. read_file utilise également une limite par défaut de 2 000 lignes au lieu de 500.⁵⁵

Le reste de la version :

• Voix conversationnelle. TTS en streaming avec interruption vocale et mots d’activation traités sur l’appareil.⁵⁵
• A2A v1.0. Un plugin de protocole de communication entre agents, qui répond à la demande de longue date de l’issue #514.⁵⁵
• Webhooks sortants signés. hermes webhook ne prenait auparavant en charge que les événements entrants ; la v0.20.0 ajoute des webhooks de cycle de vie sortants signés par HMAC pour les événements de session, de tour et d’outil.⁵⁵
• Citations étayées. Un nouveau skill doté d’un mode de vérification des faits.⁵⁵
• Vague d’améliorations du CLI pour les utilisateurs avancés. !command exécute immédiatement une commande shell sans consommer de tour du modèle ; /init analyse le projet et crée ou met à jour un fichier AGENTS.md ; /diff affiche les modifications indexées, l’ensemble des modifications ou celles de la session depuis n’importe quelle interface ; /context détaille ce qui occupe la fenêtre de contexte ; /focus propose une vue aux sorties réduites permettant de récupérer les lignes masquées ; Ctrl+S met de côté une invite en cours de rédaction. hermes import-agent migre une configuration Claude Code ou Codex CLI en une seule commande.⁵⁵
• Ajouts à l’interface de gestion des secrets. Une source de secrets reposant sur une commande auxiliaire et compatible avec tous les coffres, la rotation des jetons en une seule commande avec des erreurs de démarrage exploitables, un cache de secours chiffré et facultatif pour Bitwarden, des clés injectées depuis un coffre et limitées au dossier personnel de chaque profile, ainsi que la parité des SecretRef ${env:VAR} entre config.yaml et la configuration MCP. Le modèle d’authentification à trois voies présenté ci-dessous reste inchangé.⁵⁵
• Démarrage à chaud plus rapide. Le démarrage à froid de hermes -w est passé d’environ 14 s à 1,8 s.⁵⁵
• L’application de bureau est devenue une plateforme. Des artefacts avec des cartes versionnées et un aperçu dynamique exécuté dans une sandbox, un SDK de plugins avec Kanban comme premier plugin de bureau, un raccourci clavier global de saisie rapide, plusieurs fenêtres d’interface graphique, un mode backend distant SSH et une connexion native conforme à la RFC 8252.⁵⁵

Les regroupements des v0.20.3, v0.20.4, v0.20.5 et v0.20.6 (17-27 août)

Après la v0.20.0, le projet a adopté un rythme soutenu de regroupements assortis de tags, et ceux-ci ne se limitaient pas à la stabilisation. Les quatre ont reporté leurs notes éditorialisées de la même manière — chacun indiquait que « full curated release notes for this window will ship with v0.21.0 » — et la v0.21.0 les a désormais livrées : la section Nouveautés de la v0.21.0 ci-dessus constitue le récapitulatif éditorialisé de toute cette période (la version confirme que ces fenêtres « are fully documented here »). Les blocs ci-dessous sont conservés comme relevé contemporain de chaque tag — ils indiquent précisément les apports de chacun, que les notes éditorialisées regroupent.^54233035

v0.20.3 (environ 250 commits et 125 PR depuis la v0.20.2) :

• Migration vers le SDK MCP 2.x, avec prise en charge du protocole sans état du 28 juillet 2026. Hermes adopte la génération actuelle du SDK MCP et communique selon la révision sans état du protocole.⁵⁴
• Bot Mode est fourni sous la forme d’un plugin intégré (hermes-bots) qui embarque le protocole central de collaboration.⁵⁴
• Un plugin de fournisseur CommandCode rejoint le catalogue de fournisseurs.⁵⁴
• Contrats d’exécution Cua Driver 0.20 pour l’utilisation de l’ordinateur, ainsi qu’un renforcement de la gestion de l’environnement d’exécution Python des sous-processus (isolation de PYTHONHOME/PYTHONPATH).⁵⁴
• Fiabilité : autoréparation du planificateur cron (récupération après EMFILE, rapprochement des revendications obsolètes, réarmement des tâches bloquées), corrections des pertes de données lors du transfert de sessions, autoréparation des connexions au gateway distant depuis l’application de bureau et vague de portages dans l’écosystème (analyse de sécurité à l’installation des plugins, /worktree, préservation des modifications manuelles par /rollback, lecture des fichiers UTF-16).⁵⁴

v0.20.4 (environ 146 commits et 74 PR depuis la v0.20.3) :

• La surface en verre de l’application de bureau : effets de verre mat et de translucidité, avec un sélecteur de givre et une présélection pour macOS.⁵⁴
• Une barre latérale à onglets SESSIONS|BOTS permettant de masquer ou d’afficher chaque bot, ainsi que des corrections apportées aux discussions de groupe de Bot Mode (tours de membres de longue durée, rendu Markdown, routage entre machines).⁵⁴
• Analyse consultative NVIDIA SkillEvaluator Tier 1 lors de l’installation des skills — des vérifications de licence et de sécurité s’exécutent lorsque vous installez un skill.⁵⁴
• Renforcement de l’envoi de médias par cron (délai d’expiration configurable, pièces jointes lors des exécutions manuelles, signalement des déclenchements manqués), corrections de SessionDB concernant le thread de la boucle d’événements et les conflits d’accès, transparence de hermes update sur les branches mises en attente et notifications natives du système d’exploitation pour Kanban.⁵⁴

v0.20.5 (environ 746 commits et 323 PR depuis la v0.20.4) :

• Le niveau web sans clé : la recherche web fonctionne sur les nouvelles installations sans aucune clé API — une rotation gratuite entre 5 fournisseurs avec basculement en anneau.²³
• Une vague de finitions du CLI : sélecteur approximatif /model, palette de commandes avec Ctrl+P et /status plus détaillé.²³
• Bot Mode gagne en maturité : fils de discussion dans les salles de groupe, résumés de conversation repliables, avatars aux visages informes et pièces jointes PDF/fichiers par glisser-déposer.²³
• Outils pour les flottes et les worktree : reçus de hermes update, hermes update --plan (les notes de version parlent de vérification « fleet --plan » ; l’option appartient à hermes update, et non à une commande fleet, et l’aide de son analyseur indique qu’elle « Show the update plan and exit without changing anything »), ainsi que hermes worktree list/prune.²³²⁷
• Les tâches cron bénéficient d’une mémoire persistante et d’un effort de raisonnement propre à chaque tâche, ainsi que de règles de discipline d’exécution et de protections contre le blocage de l’environnement d’exécution, inspirées des conclusions de l’évaluation Composio, d’un mécanisme de clarification à plusieurs questions, du fournisseur sans authentification et indépendant d’opencode, et d’améliorations des performances de l’application de bureau (hydratation de Bot Mode donnant la priorité à l’affichage, React Compiler dans les deux moteurs de rendu).²³

v0.20.6 (tag v2026.8.27, 27 août — environ 1 313 commits et 525 PR depuis la v0.20.5) :

La version se décrit explicitement comme une « Patch release. This tag rolls up the ~525 PRs merged since v0.20.5 into a stable tagged release for downstream consumers », et sa propre description évalue cette période à environ 1 313 commits répartis sur quelque 1 557 fichiers (+177 113 / −21 682), soit environ 525 PR fusionnées.³⁰ Voici les principales nouveautés mentionnées dans cette description :

• Navigation avec le profile réel soumise au consentement — la navigation locale peut utiliser votre profile Chromium par défaut, avec sous Windows un processus de fermeture soumis à votre approbation.³⁰
• Le navigateur de l’application de bureau dispose de sa propre fenêtre système, ainsi que d’un moteur géré de mises à jour distantes SSH et d’un rail de profiles pour les flottes.³⁰
• Extension du catalogue MCP distant : plus de 50 serveurs hébergés par des fournisseurs et vérifiés en conditions réelles, notamment Cloudflare, Grafana Cloud, Better Stack et Railway.³⁰
• Chiffrement facultatif des secrets stockés par le trousseau du système d’exploitation — fini les demandes du trousseau macOS à chaque lancement.³⁰
• Nouveaux modèles dans les sélecteurs : GLM-5.3-Flash, MiniMax M3 free et MiniMax H3 Max video.³⁰
• Mise en cache des résultats avec TTL pour web_search/web_extract et tool_search à requêtes multiples avec recherche par racine lexicale.³⁰
• La compression lean-tail est désormais utilisée par défaut — la section Compression du contexte ci-dessous documente la configuration correspondant à ce tag.³⁰³¹
• Les backends de terminal sont devenus modulaires — consultez Backends de terminal.³⁰³²
• Transparence des outils de mise à jour et des flottes : les outils de mise à jour suspendent les gateways au moyen du socket de contrôle au lieu de mettre fin à toute leur arborescence de processus, tandis que les installations gérées par image ou paquet refusent les mises à jour sur place non sécurisées.³⁰
• Accusés de réception durables des incidents cron avec des erreurs plus claires en cas de divergence du code, contrôles du déploiement des aperçus de liens Slack et identités de conteneur Docker partagées.³⁰

La procédure de mise à jour reste inchangée : hermes update depuis une installation existante, ou le programme d’installation shell pour une nouvelle installation.⁵⁴²³³⁰

Nouveautés de la v0.19.0 (The Quicksilver Release)

Hermes Agent v0.19.0 (tag v2026.7.20, 20 juillet 2026) tire son nom de la vitesse du dieu messager lui-même : cette version repose avant tout sur la réactivité pure, avec une réduction d’environ 80 % du délai avant le premier token lors du premier échange, sur toutes les plateformes. Autour de cet axe central viennent s’ajouter la gestion de la facturation dans le terminal, la récupération des secrets depuis des gestionnaires de mots de passe, les approbations intelligentes par défaut, des sous-agents observables et une livraison des réponses résistante aux plantages. Depuis la v0.18.0, cette période est la plus importante de l’histoire du projet : environ 2 245 commits, 1 065 PR fusionnées, 3 300 issues clôturées et plus de 450 contributeurs de la communauté.⁵⁶

• Environ 80 % plus rapide avant le premier token, partout. Le délai à froid entre l’envoi et l’exécution est passé d’environ 4,3 s à 0,9 s sur le CLI, le gateway, la TUI, l’application de bureau et cron : la détection des fonctionnalités de Discord a été retirée du chemin critique, la vérification d’Ollama est ignorée pour les fournisseurs connus comme n’utilisant pas Ollama et les opérations bloquantes ont été supprimées de l’initialisation de l’agent. La latence perçue a également fait l’objet d’une optimisation spécifique : les modèles de raisonnement diffusent désormais leur réflexion en direct par défaut (display.show_reasoning est activé), tandis que la zone de réponse s’actualise à chaque token plutôt qu’à chaque ligne.⁵⁶
• Vague d’optimisations du rendu sur l’application de bureau et la TUI. L’application de bureau a bénéficié d’une refonte des performances répartie sur une vingtaine de PR : consommation du processeur divisée par 14 dans le séparateur de Markdown diffusé grâce à une analyse lexicale incrémentielle par blocs, diffs virtualisés dans le volet de révision, changement de session réactif même avec de longues transcriptions et suppression des nouveaux rendus de la barre latérale et des lignes d’outils à chaque token. La TUI affiche désormais le Markdown diffusé de manière incrémentielle, bloc par bloc.⁵⁶
• Les installations via pip et Homebrew sont obsolètes. Ces deux méthodes ont été qualifiées d’installations « héritées non prises en charge », dont la suppression était prévue. Cette suppression a depuis eu lieu dans la v0.20.0 : les canaux brew et pip/PyPI wheel ont été retirés ; seuls le programme d’installation shell, Docker et Nix restent pris en charge.⁵⁶⁵⁵
• Les secrets peuvent provenir de votre gestionnaire de mots de passe. Une nouvelle interface extensible SecretSource récupère les secrets de Bitwarden et de 1Password (références op://) au chargement. Elle permet d’utiliser simultanément plusieurs coffres, avec un ordre de priorité déterministe, des avertissements en cas de conflit et la traçabilité de chaque variable : les clés API ne doivent donc plus nécessairement résider dans un fichier .env en texte brut. De futurs fournisseurs de coffres pourront être ajoutés sous forme de plugins.⁵⁶
• Les approbations intelligentes sont désormais activées par défaut. Lorsque Hermes souhaite exécuter une commande signalée, un réviseur LLM indépendant l’évalue au lieu de vous demander de confirmer chacune d’elles ; chaque verdict ne couvre que cette commande précise. Des règles de refus définies par l’utilisateur bloquent les commandes correspondantes, même en mode YOLO ; /deny <reason> transmet le motif de votre refus afin que l’agent rectifie son approche ; enfin, l’action d’approbation pre_tool_call du plugin, réintroduite avec des clés de règles, soumet un appel d’outil à la validation d’une personne.⁵⁶
• Facturation dans le terminal : /subscription et /topup. Gérez votre formule Nous Portal sans quitter le terminal : consultez votre offre et votre quota restant, visualisez précisément le coût d’un passage à l’offre supérieure ou la date d’effet d’un passage à l’offre inférieure, puis appliquez la modification avec possibilité de l’annuler. L’application de bureau bénéficie d’un onglet équivalent dans les paramètres de facturation.⁵⁶
• Observez les sous-agents travailler sans jamais perdre une réponse terminée. Les exécutions lancées par delegate_task produisent des fichiers de transcription en direct que vous pouvez consulter avec tail -f dès le démarrage des sous-agents : chaque appel d’outil, résultat et réponse diffusée figure dans un journal lisible dédié à chaque enfant. Les résultats des délégations en arrière-plan persistent après un redémarrage. Les réponses finales du gateway sont par ailleurs consignées dans un registre des obligations de livraison au sein de state.db, puis renvoyées au démarrage suivant si le gateway s’interrompt en cours d’envoi. L’option de configuration max_async_children est obsolète au profit de limites unifiées de concurrence des délégations.⁵⁶
• Un seul gateway, plusieurs profiles. Un gateway multiplexé unique partageant un même token de bot peut acheminer des guildes, canaux ou fils de discussion précis vers différents profiles, chacun disposant de sa propre configuration, de ses skills, de sa mémoire et de ses secrets entièrement isolés, avec une option de remplacement GATEWAY_MULTIPLEX_PROFILES. L’index de routage a été déplacé dans state.db ; sessions.json n’est désormais plus qu’un miroir hérité facultatif.⁵⁶
• Vague de nouveaux fournisseurs et modèles. Fireworks AI bénéficie désormais d’une intégration native (estimation des coûts et deuxième place dans le sélecteur de fournisseurs), aux côtés de DeepInfra et Upstage Solar. Les catalogues accueillent GPT-5.6 (Sol/Terra/Luna + Pro, intégré de bout en bout), grok-4.5 (disponibilité générale), kimi-k3 (kimi-k2.x est retiré) et Claude Sonnet 5 entièrement intégré. Un indicateur enabled: false propre à chaque fournisseur et la configuration excluded_providers retirent les fournisseurs inutilisés des sélecteurs /model et du processus de résolution.⁵⁶
• L’intensité du raisonnement devient réglable. Les nouveaux niveaux d’effort max et ultra sont disponibles sur toutes les interfaces, avec des réglages propres à chaque modèle dans la configuration, un niveau d’effort par emplacement dans les préréglages MoA (les conseillers approfondissent leur réflexion tandis que le synthétiseur reste rapide), un effort par tâche pour les modèles auxiliaires et une commande /reasoning limitée à la session dans le CLI.⁵⁶
• Évolutions du CLI et de MCP. hermes sessions export exporte aux formats Markdown, Quarto, HTML, prompt uniquement et trace Hugging Face, avec un nettoyage facultatif via --redact ; /model --once permet de remplacer le modèle pour un seul échange ; les appels de slash-skills peuvent s’enchaîner (/skill-a /skill-b do XYZ) ; --safe-mode facilite le dépannage ; hermes config get/unset complètent la gestion de la configuration ; hermes serve devient un véritable backend headless ; enfin, les outils MCP adoptent la convention de nommage mcp__server__tool.⁵⁶

Si vous effectuez une mise à niveau depuis la v0.18.x, deux changements méritent votre attention en priorité : une installation avec pip ou Homebrew est désormais signalée comme héritée et non prise en charge — migrez vers le programme d’installation en une ligne — et max_async_children est obsolète au profit des limites unifiées de concurrence des délégations. Tout le reste est additif : les principales raisons d’effectuer la mise à niveau sont la réduction d’environ 80 % de la latence du premier échange, les approbations intelligentes et le registre de livraison qui protège les réponses terminées contre les plantages.

Nouveautés de la v0.18.0 (The Judgment Release)

Hermes Agent v0.18.0 (tag v2026.7.1, 1er juillet 2026) tire son nom du jugement : l’agent vérifie son propre travail au lieu d’en revendiquer la réussite, tandis que le raisonnement en ensemble devient réellement observable. Cette version résorbe également l’intégralité du retard P0/P1, soit environ 692 éléments de priorité maximale résolus en douze jours.²²

• Mixture-of-Agents comme modèle de premier ordre. MoA peut désormais être sélectionné comme n’importe quel autre modèle dans toutes les interfaces, et le raisonnement de l’ensemble est visible : la sortie complète de chaque modèle de référence s’affiche dans son propre bloc étiqueté, avec diffusion de la réponse en direct. Vous pouvez ainsi observer l’ensemble réfléchir au lieu de recevoir une réponse fusionnée opaque.²²
• Contrats d’achèvement pour /goal. Avant de signaler qu’un objectif est atteint, l’agent vérifie son propre travail en exécutant les contrôles du projet au lieu de simplement revendiquer sa réussite : il applique son jugement à lui-même.²²
• /learn — décrivez n’importe quoi pour en faire un skill. Transformez un processus en skill réutilisable en le décrivant ; les skills générés respectent automatiquement les conventions du fichier CONTRIBUTING.md du dépôt.²²
• Chronologie /journey. Un historique visuel de la mémoire et des skills au fil du temps, avec des fonctions d’édition, ainsi qu’un graphe de mémoire dans l’application de bureau.²²
• Déploiement en éventail des sous-agents en arrière-plan. Déléguez plusieurs tâches exécutées simultanément sans interrompre la conversation : l’unique sous-agent en arrière-plan de la v0.17.0 devient toute une flotte.²²
• Projects dans l’application de bureau. Des Projects de développement de premier ordre, organisés selon un modèle projet/dépôt/couloir.²²
• Gateway avec mise à l’échelle jusqu’à zéro. Les gateways peuvent passer en veille lorsqu’ils sont inactifs et coordonner leur drainage pour assurer des déploiements fluides : une avancée importante pour toute personne exécutant Hermes comme service permanent.²²
• Prise en charge de Google Vertex AI. Accès à Gemini par l’intermédiaire de comptes de service GCP, avec actualisation automatique du token OAuth2, désormais intégré au catalogue des fournisseurs.²²
• Commande d’édition /prompt. Ouvre $EDITOR pour rédiger des prompts multilignes au lieu de lutter avec la ligne de saisie.²²

Si vous effectuez une mise à niveau depuis la v0.17.x, aucun de ces changements ne rompt le CLI. Les principales raisons d’effectuer la mise à niveau sont les contrats d’achèvement — des objectifs qui se vérifient eux-mêmes —, MoA comme modèle de premier ordre avec des ensembles observables et /learn pour enregistrer des skills.

Nouveautés de la v0.17.0 (The Reach Release)

Hermes Agent v0.17.0 (tag v2026.6.19, 19 juin 2026) doit son nom à l’élargissement de la portée de l’agent : nouveaux canaux de messagerie, nouveaux fournisseurs de modèles et contrôle plus poussé de l’application de bureau et du tableau de bord. Cette version complète la v0.16.x ; l’interface CLI reste inchangée.²¹

• Nouveaux canaux de messagerie. iMessage fonctionne désormais sans relais Mac grâce à Photon Spectrum (OAuth par code d’appareil, hermes photon login) ; l’API WhatsApp Business Cloud est un adaptateur Meta officiel qui supprime la nécessité d’un processus de passerelle ; SimpleX prend maintenant en charge les groupes, les pièces jointes natives, le regroupement des textes et l’acceptation automatique ; enfin, Raft rejoint les plateformes intégrées sous forme de plugin, avec une conception de canal de réveil garantissant contractuellement la confidentialité.²¹
• Nouveaux modèles et fournisseurs. Le catalogue accueille z-ai/glm-5.2 (contexte de 1M), anthropic/claude-fable-5, laguna-m.1, nemotron-3-ultra et grok-composer-2.5-fast (le modèle de Cursor via OAuth xAI, contexte de 200k). Le modèle xAI par défaut devient grok-build-0.1, tandis que les modèles adaptatifs Anthropic suivent désormais le contrat de raisonnement moderne (ils n’envoient jamais de champ reasoning).²¹
• Application de bureau et tableau de bord. L’application de bureau ajoute des sous-agents en arrière-plan, avec des « fenêtres de suivi » diffusant en direct l’activité déléguée (delegate_task(background=true)), un sélecteur de modèle Composer, des raccourcis clavier reconfigurables, des notifications natives du système d’exploitation, des brouillons de rédaction propres à chaque fil, des thèmes du VS Code Marketplace ainsi qu’une interface en japonais et en chinois traditionnel. Le tableau de bord ajoute un éditeur complet de profile (modèle/skills/MCPs sans modifier config.yaml), un sélecteur global de profile, un Skills Hub repensé avec analyse de sécurité, des Automation Blueprints (modèles paramétrables utilisables depuis un formulaire, une commande slash, une conversation ou la documentation) et une connexion sécurisée qui renvoie une erreur 401 derrière la protection OAuth.²¹
• Skills et outils. image_generate peut désormais modifier et transformer une image source, et non plus seulement en créer une de toutes pièces, avec tous les fournisseurs d’images pris en charge ; l’outil memory bénéficie d’un tableau operations permettant d’ajouter, de remplacer ou de supprimer des éléments par lots atomiques en un seul appel ; un nouveau skill simplify-code exécute en parallèle une passe de révision et de nettoyage confiée à trois agents, conditionnée par un niveau de risque fondé sur le principe de la barrière de Chesterton ; enfin, le booléen write_approval remplace l’option ternaire write_mode.²¹
• Architecture. Les sous-agents en arrière-plan renvoient immédiatement un identifiant et réinjectent leur résultat dans un nouveau tour ; un gestionnaire de sollicitation MCP permet de demander une confirmation en cours d’appel d’outil, tandis que les outils MCP qui se connectent tardivement sont exposés entre les tours sans compromettre le cache ; cron devient un CronScheduler extensible doté d’un fournisseur de cron géré Chronos ; enfin, un nouveau périmètre Managed (/etc/hermes) permet à un administrateur de verrouiller une configuration que l’utilisateur ne peut pas modifier, parallèlement à un relais Gateway-Gateway destiné aux topologies à plusieurs gateway.²¹
• Nouvelles commandes. /version, /billing (facturation interactive dans le terminal), hermes photon login (authentification iMessage) et hermes curator run --consolidate : la consolidation est désormais facultative, si bien que la curation courante en arrière-plan ne consomme aucun token.²¹
• Sécurité. La v0.17.0 corrige un contournement de la liste de refus par échappement shell, bloque par défaut les opérations en l’absence de modules d’approbation ou d’adaptateurs gateway appliquant leur propre politique, assainit l’environnement des sous-processus exécutant les scripts de tâches cron, masque les secrets dans les journaux de débogage des requêtes, recherche les motifs d’exfiltration dans les configurations stdio MCP et met à jour urllib3 ainsi que PyJWT afin de corriger plusieurs CVE.²¹

Si vous effectuez une mise à niveau depuis la v0.16.x, rien ici ne rompt l’interface CLI : il s’agit de nouveaux canaux, modèles et points d’accès autour du même agent. iMessage sans relais, les adaptateurs WhatsApp officiels et le périmètre Managed destiné aux administrateurs sont les principales raisons d’effectuer la mise à niveau.

Nouveautés de la v0.16.0 (The Surface Release)

Hermes Agent v0.16.0 (tag v2026.6.5, 5 juin 2026) doit son nom aux nouvelles interfaces proposées pour interagir avec l’agent, qui reste centré sur CLI. La grande nouveauté : Hermes n’est plus limité au terminal.²⁰

• Application de bureau native. Hermes Desktop est une nouvelle application Electron pour macOS, Linux et Windows, qui s’installe en un clic et se met à jour directement depuis l’application. Elle propose une fenêtre de chat en streaming, le glisser-déposer de fichiers, le collage d’images depuis le presse-papiers, une palette Cmd+K, une liste des sessions avec archivage et recherche, ainsi qu’un sélecteur de modèle dans la barre d’état. Elle peut se connecter à distance à une gateway Hermes par l’intermédiaire d’un WebSocket sécurisé, avec une authentification par OAuth ou par nom d’utilisateur et mot de passe, des hôtes distants propres à chaque profile et des sessions simultanées sur plusieurs profiles reliées par des références @session inter-profiles. L’interface de bureau propose également une traduction intégrale en chinois simplifié (简体中文) au moyen d’une couche i18n typée (display.language ; l’anglais reste la langue par défaut).²⁰
• Panneau d’administration dans le navigateur. Le tableau de bord web local évolue d’une simple vue d’état vers un panneau d’administration complet : catalogue MCP avec commandes d’activation et de désactivation, gestion des identifiants, création de webhooks et de hooks, configuration de la mémoire, commandes de la gateway et page System avec vérification préalable aux mises à jour et Debug Share en un clic. Une nouvelle page Channels permet de configurer depuis le navigateur chaque plateforme de messagerie de la gateway (Telegram, Discord, Slack et les autres). L’authentification est désormais extensible : connexion par nom d’utilisateur et mot de passe, fournisseur OIDC générique auto-hébergé, hermes dashboard register pour un client OAuth auto-hébergé et rotation des sessions à l’aide de refresh tokens.²⁰
• Nouvelles commandes CLI et slash. /undo [N] revient sur les N derniers tours utilisateur avec préremplissage et suppression réversible ; la commande fonctionne dans CLI, la TUI et sur les plateformes de messagerie. Une interface par défaut configurable (cli ou tui) est ajoutée, avec l’option --cli pour la remplacer ponctuellement ; la TUI bénéficie d’une commande /model unifiée et d’une fenêtre superposée Sessions. hermes portal devient un alias lisible du parcours d’intégration de Nous Portal, lequel propose désormais les options Quick Setup et Full Setup au premier lancement. Deux outils de diagnostic font aussi leur apparition : hermes prompt-size et hermes sessions optimize.²⁰
• Nouveaux modèles et fournisseurs. Le sélecteur accueille deepseek-v4-flash, MiniMax-M3 (contexte de 1M, fournisseurs MiniMax natifs), qwen3.7-plus (Nous + OpenRouter) et gemini-3.5-flash (OAuth Gemini + clé API). Un fournisseur OAuth xAI Grok de premier ordre rejoint le lanceur de l’application de bureau ; le sélecteur de modèle prend en charge la recherche approximative sur toutes les interfaces ; les fournisseurs proposant plusieurs points de terminaison sont regroupés sur une seule ligne ; enfin, l’actualisation du catalogue passe d’une fréquence quotidienne à une fréquence horaire.²⁰ (Depuis, la v0.21.1 a de nouveau modifié cette fréquence : les catalogues distants du sélecteur sont actualisés toutes les 20 minutes, model_catalog.ttl_minutes.⁴⁶)
• Skills allégés et divulgation progressive. Le jeu de skills par défaut abandonne les skills redondants ou obsolètes (Spotify devient un plugin natif, Linear passe à hermes mcp install linear et plusieurs entrées périmées sont supprimées), transfère davantage de skills vers la catégorie facultative et ajoute dans le frontmatter un filtre de pertinence environments: (kanban/docker/s6), qui écarte de l’index les skills propres à un contexte jusqu’à ce qu’ils soient demandés. NVIDIA/skills figure désormais parmi les sources fiables par défaut du Skills Hub, aux côtés d’OpenAI, Anthropic et HuggingFace. Les outils MCP et ceux des plugins bénéficient d’une divulgation progressive et ciblée ; un bug d’MCP qui indiquait à tort la réussite de l’authentification OAuth alors qu’aucun token n’avait été obtenu est également corrigé.²⁰
• Sécurité. La v0.16.0 impose une version corrigée de Starlette (≥1.0.1) pour la CVE-2026-48710 (BadHost), retire de la boucle d’événements les vérifications d’URL contre les SSRF dans les parcours asynchrones, supprime de l’environnement des sous-processus le bearer token d’inférence Bedrock, ajoute bws_cache.json au dispositif de protection de lecture des fichiers, ajoute docker restart/stop/kill à la liste des motifs dangereux et assainit les caractères Unicode invisibles dans le contenu validé des skills. Cette version corrige 2 problèmes P0 et 62 problèmes P1, dont 16 liés à la sécurité.²⁰

Si vous effectuez une mise à niveau depuis la v0.15.x, rien ici ne constitue un changement incompatible pour l’interface CLI elle-même ; il s’agit de nouvelles interfaces et de nouveaux fournisseurs autour du même agent. L’application de bureau et le panneau d’administration justifient la mise à niveau si vous souhaitez proposer Hermes à des utilisateurs qui ne travaillent pas dans un terminal ou administrer une gateway distante depuis un navigateur.

Nouveautés de la v0.14.0 (The Foundation Release)

La v0.14.0 ne repose pas tant sur une fonctionnalité phare que sur la simplification de la configuration et l’élargissement des environnements dans lesquels Hermes peut fonctionner.¹⁹ Principales évolutions opérationnelles :

• Installation et démarrage allégés. pip install hermes-agent fonctionne depuis PyPI, les adaptateurs lourds s’installent à la demande lors de leur première utilisation et le processus de lancement diffère suffisamment d’opérations pour réduire le démarrage à froid d’environ 19 secondes. (Depuis, la v0.19.0 a rendu obsolètes les installations avec pip — consultez la section Installation.)
• Les abonnements peuvent devenir des points de terminaison API locaux. hermes proxy transforme les fournisseurs reposant sur OAuth, tels que Claude Pro, ChatGPT Pro et SuperGrok, en un point de terminaison local compatible avec OpenAI pour des outils comme Codex, Aider, Cline et Continue.
• La portée de la gateway s’étend. LINE et SimpleX Chat rejoignent la gateway (le tableau comparatif des plateformes dans la documentation en recense 28 au tag v2026.8.31 ; la section Gateway de messagerie précise ce que ce nombre englobe), Microsoft Teams est intégré de bout en bout, la récupération de l’historique Discord est activée par défaut et les invites clarify de Telegram/Discord utilisent désormais des boutons natifs.
• La vérification au moment de l’écriture progresse. Après une modification, Hermes peut afficher, pour chaque tour, un récapitulatif des mutations de fichiers et les diagnostics sémantiques du serveur de langage avant le tour suivant, ce qui le rapproche d’un fonctionnement d’agent fondé sur des preuves.
• Les outils de bureau et multimédias s’enrichissent. computer_use fonctionne par l’intermédiaire de cua-driver pour les fournisseurs autres que Anthropic, video_generate est unifié derrière des backends extensibles et vision_analyze envoie les pixels bruts aux modèles réellement capables de les interpréter.

Installation

Le programme d’installation en une ligne constitue la méthode d’installation prise en charge. Il gère Python, uv, Node.js, ripgrep, ffmpeg, le clonage du dépôt, l’environnement virtuel et la commande globale hermes.⁷

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Les installations via pip et Homebrew sont obsolètes depuis la version v0.19.0. Le paquet PyPI introduit par la version v0.14.0 (pip install hermes-agent) et la formule Homebrew sont désormais signalés comme des installations « anciennes non prises en charge » : toutes les interfaces affichent un avertissement (sans blocage) lorsque Hermes en détecte une, et l’arrêt de la publication sur PyPI/Homebrew est prévu. Si vous avez effectué l’installation via pip ou brew, migrez vers le programme d’installation ci-dessus.⁵⁶

Compatible avec Linux, macOS, WSL2 et Android/Termux (le programme d’installation détecte automatiquement Termux et utilise un ensemble de paquets Android testé).⁷ Windows natif est désormais une plateforme de niveau Tier 1, plutôt que la version bêta préliminaire livrée avec la v0.14.0 : installez-le avec iex (irm https://hermes-agent.nousresearch.com/install.ps1). La documentation souligne toutefois une restriction : la prise en charge de macOS est réservée aux Mac avec Apple Silicon, les Mac Intel n’étant pas pris en charge.⁵⁵ Historiquement, la v0.14.0 a ajouté la prise en charge native de Windows en version bêta préliminaire via un programme d’installation PowerShell, mais WSL2 reste la recommandation la plus sûre pour un usage en production jusqu’à ce que la solution Windows gagne en maturité.¹⁹

Une fois l’installation terminée :

source ~/.bashrc    # or ~/.zshrc
hermes              # Start chatting

Le seul prérequis est git. Le programme d’installation fournit automatiquement Python 3.11 via uv (sans sudo), Node.js 26 (pour l’automatisation du navigateur et la passerelle WhatsApp), ripgrep et ffmpeg. Depuis la v0.20.0, Node 26 est la version minimale obligatoire : le programme d’installation refuse toute version antérieure et installe à la place une version de Node gérée par Hermes.⁵⁵⁷

Vérifier l’installation

hermes --version    # Check version (global flag; there is no `version` subcommand)
hermes doctor       # Diagnose config/dependency issues
hermes status       # Show current configuration + auth state
hermes dump         # Copy-pasteable setup summary for debugging

hermes doctor vous indique précisément ce qui manque et comment y remédier.⁷ Lorsque vous demandez de l’aide, hermes dump est la commande de diagnostic à coller dans un ticket GitHub ou une discussion Discord : elle produit un résumé en texte brut de l’ensemble de votre configuration, dont les secrets sont masqués.⁸

Installation manuelle

Si vous avez besoin d’un contrôle total — version personnalisée de Python, extras spécifiques, intégration à Nix/NixOS — la procédure manuelle est documentée étape par étape dans le guide d’installation du projet d’origine.⁷ Voici les principaux extras facultatifs que vous pouvez combiner avec uv pip install -e ".[<extras>]" :

La commande d’installation pour Termux est différente : elle utilise pip avec un fichier de contraintes, et non uv pip :

python -m pip install -e ".[termux]" -c constraints-termux.txt

En effet, sur Android, .[all] installe faster-whisper via l’extra voice, qui dépend de paquets wheel ctranslate2 non publiés pour Android.⁷

Authentification et fournisseurs

Au tag v2026.9.7, hermes_cli/models_catalog_static.py contient 39 entrées statiques CANONICAL_PROVIDERS à la ligne 311 (la décomposition de septembre 2026 a déplacé la liste hors de hermes_cli/models.py ; les entrées elles-mêmes restent inchangées, y compris tencent-tokenplan de la v0.21.0) et complète automatiquement cette liste à partir de plugins/model-providers/ (39 dossiers intégrés ; neuf d’entre eux — actual, alibaba-coding-plan, commandcode, deepinfra, meta-ai, nebius-token-factory, opencode-free, router, upstage — n’ont aucune entrée statique et sont intégrés par l’extension automatique, car ils utilisent le type d’authentification api_key par défaut). Les tableaux de la page de documentation consacrée aux fournisseurs recensent 45 fournisseurs cloud et sur abonnement, ainsi qu’une ligne pour les endpoints personnalisés. La page présente séparément les serveurs locaux et auto-hébergés (Ollama, vLLM, SGLang, llama.cpp, LM Studio, LiteLLM, ClawRouter et tout endpoint compatible avec OpenAI).²⁶ Au tag v2026.9.24, la liste statique contient toujours 39 entrées, mais plugins/model-providers/ ne compte plus que 38 dossiers : le fournisseur sans clé opencode-free a été supprimé le 18 septembre, car l’offre gratuite d’OpenCode rejette désormais le trafic anonyme provenant d’un autre client que le sien.⁵³ À cela s’ajoutent les endpoints personnalisés et trois parcours d’authentification distincts. Voici l’ensemble des options d’authentification, classées par parcours afin que vous puissiez trouver celle qui correspond à vos besoins.

Les trois parcours d’authentification

Chaque fournisseur dans Hermes suit l’un de ces trois modes d’authentification :

Parcours 1 — clé API dans .env. Placez votre clé dans ~/.hermes/.env ; Hermes la lit au démarrage. Ce parcours est utilisé par OpenRouter, AI Gateway, z.ai/GLM, Kimi/Moonshot, MiniMax (ainsi que MiniMax China), Alibaba Cloud/DashScope, Kilo Code, OpenCode Zen, OpenCode Go, DeepSeek, Hugging Face, Google/Gemini et la plupart des fournisseurs tiers.² Depuis la v0.19.0, la clé n’a plus besoin d’être stockée dans un fichier en texte brut : une interface SecretSource extensible peut récupérer les secrets depuis Bitwarden ou 1Password (références op://) au chargement, avec la prise en charge simultanée de plusieurs coffres-forts, un ordre de priorité déterministe, des avertissements en cas de conflit et la provenance de chaque variable — .env reste la solution de secours. (Ce mécanisme se distingue du jeton d’amorçage Bitwarden Secrets Manager de la v0.15.0, qui regroupait les clés des fournisseurs derrière un seul jeton ; SecretSource remplace le fichier en texte brut lui-même, et de futurs fournisseurs de coffres-forts pourront être ajoutés sous forme de plugins.)⁵⁶

Parcours 2 — OAuth via hermes model ou hermes auth. Lance un flux de code d’appareil, ouvre un navigateur et stocke les identifiants dans ~/.hermes/auth.json (avec la possibilité d’importer les identifiants existants d’outils comme Claude Code ou Codex CLI). Ce parcours est utilisé par Nous Portal, OpenAI Codex (compte ChatGPT), GitHub Copilot et Anthropic (Claude Pro/Max).²

Parcours 3 — endpoint personnalisé dans config.yaml. Pour tout API compatible avec OpenAI — Ollama, vLLM, SGLang, llama.cpp, LM Studio, proxy LiteLLM, Together AI, Groq, Azure OpenAI ou votre propre serveur auto-hébergé. La configuration s’effectue une seule fois via hermes model → Custom endpoint, puis elle est enregistrée dans config.yaml.²

Matrice complète des fournisseurs

Cette matrice couvre les fournisseurs répertoriés dans les tableaux de la page de documentation, avec la procédure de configuration exacte de chacun ; le sélecteur du tag en propose davantage que la documentation (voir le décompte ci-dessus), et tout service compatible avec OpenAI peut passer par la ligne consacrée aux endpoints personnalisés.²²⁶

Anthropic : trois méthodes d’authentification

Anthropic dispose de sa propre section, car Hermes propose trois voies distinctes pour accéder à Claude, et il est essentiel de choisir la bonne. D’après la documentation en amont :²

# Method 1: API key (pay-per-token)
export ANTHROPIC_API_KEY=***
hermes chat --provider anthropic --model claude-sonnet-4-6

# Method 2: OAuth through hermes model (preferred)
# Uses Claude Code's credential store when available
hermes model

# Method 3: Manual setup-token (fallback/legacy)
export ANTHROPIC_TOKEN=***
hermes chat --provider anthropic

# Auto-detect Claude Code credentials
hermes chat --provider anthropic   # reads Claude Code files automatically

Lorsque vous choisissez Anthropic OAuth via hermes model, Hermes privilégie le magasin d’identifiants de Claude Code au lieu de copier le token dans ~/.hermes/.env. Les identifiants Claude actualisables restent ainsi actualisables.² Si vous utilisez déjà Claude Code sur la même machine, c’est la solution la plus propre.

Pour définir Anthropic de manière permanente dans config.yaml :

model:
  provider: "anthropic"
  default: "claude-sonnet-4-6"

--provider claude et --provider claude-code fonctionnent également comme raccourcis pour --provider anthropic.²

GitHub Copilot : deux modes

Copilot est pris en charge selon deux modes : l’accès direct à API de Copilot (recommandé) et Copilot ACP (qui lance le CLI Copilot local comme sous-processus).²

# Direct Copilot API
hermes chat --provider copilot --model gpt-5.4

# Copilot ACP (requires the Copilot CLI in PATH + an existing copilot login)
hermes chat --provider copilot-acp --model copilot-acp

D’après la documentation en amont, l’authentification est vérifiée dans l’ordre suivant :² 1. Variable d’environnement COPILOT_GITHUB_TOKEN 2. Variable d’environnement GH_TOKEN 3. Variable d’environnement GITHUB_TOKEN 4. Solution de repli CLI gh auth token 5. Connexion par code d’appareil OAuth via hermes model

Le type de token est important. Le API Copilot ne prend pas en charge les Personal Access Tokens classiques (ghp_*). Les types pris en charge sont les tokens OAuth (gho_*), les PAT à granularité fine (github_pat_* avec l’autorisation Copilot Requests) et les tokens GitHub App (ghu_*). Si gh auth token renvoie un token ghp_*, utilisez plutôt hermes model pour vous authentifier via OAuth.²

Providers d’IA chinois (prise en charge native)

Hermes intègre la prise en charge de z.ai/GLM, Kimi/Moonshot, MiniMax (endpoints mondiaux et chinois) et Alibaba Cloud, avec des identifiants de provider dédiés.²

# z.ai / ZhipuAI GLM
hermes chat --provider zai --model glm-5                 # Requires: GLM_API_KEY

# Kimi / Moonshot AI
hermes chat --provider kimi-coding --model kimi-for-coding   # Requires: KIMI_API_KEY

# MiniMax (global)
hermes chat --provider minimax --model MiniMax-M2.7          # Requires: MINIMAX_API_KEY

# MiniMax (China)
hermes chat --provider minimax-cn --model MiniMax-M2.7       # Requires: MINIMAX_CN_API_KEY

# Alibaba Cloud / DashScope (Qwen)
hermes chat --provider alibaba --model qwen3.5-plus          # Requires: DASHSCOPE_API_KEY

Les URL de base peuvent être remplacées à l’aide des variables d’environnement GLM_BASE_URL, KIMI_BASE_URL, MINIMAX_BASE_URL, MINIMAX_CN_BASE_URL ou DASHSCOPE_BASE_URL.²

Z.AI détecte automatiquement l’endpoint. Lorsque vous utilisez le provider z.ai/GLM, Hermes teste plusieurs endpoints (mondiaux, chinois et variantes destinées au codage) pour trouver celui qui accepte votre clé API. L’endpoint fonctionnel est automatiquement mis en cache : la plupart des utilisateurs n’ont donc pas besoin de GLM_BASE_URL.²

xAI (Grok) active automatiquement la mise en cache des prompts. Lorsque l’URL de base contient x.ai, Hermes envoie l’en-tête x-grok-conv-id avec chaque requête afin de la diriger vers le même serveur pendant une session de conversation, ce qui permet de réutiliser les prompts système et l’historique mis en cache.² Cette opération est automatique ; aucune configuration n’est nécessaire.

La commande hermes auth

hermes auth est la commande de gestion des identifiants pour les pools et les identifiants OAuth.⁶

hermes auth                              # Interactive wizard
hermes auth list                         # Show all credential pools
hermes auth list openrouter              # Show one provider's pool
hermes auth add openrouter --api-key sk-or-v1-xxx
hermes auth add anthropic --type oauth
hermes auth remove openrouter 2          # Remove by index
hermes auth reset openrouter             # Clear cooldowns

Les pools d’identifiants permettent d’effectuer une rotation entre plusieurs clés API ou tokens OAuth pour un même provider. Ils sont utiles pour répartir les limites de débit entre plusieurs clés sans modifier le code.⁶ Les anciennes commandes hermes login / hermes logout ont été supprimées ; utilisez désormais hermes auth.⁶

Endpoints personnalisés et auto-hébergés

Hermes fonctionne avec tout endpoint API compatible avec OpenAI. Si un serveur implémente /v1/chat/completions, vous pouvez y connecter Hermes.²

Configuration interactive (recommandée) :

hermes model
# Select "Custom endpoint (self-hosted / VLLM / etc.)"
# Enter: API base URL, API key, Model name

Configuration manuelle dans config.yaml :

model:
  default: your-model-name
  provider: custom
  base_url: http://localhost:8000/v1
  api_key: your-key-or-leave-empty-for-local

Les deux méthodes enregistrent les paramètres dans config.yaml, qui constitue la source unique de vérité pour le modèle principal, le provider et l’URL de base.² Les anciennes variables d’environnement OPENAI_BASE_URL et LLM_MODEL ne sont plus lues pour configurer le modèle principal : utilisez hermes model ou modifiez directement config.yaml.² (OPENAI_BASE_URL + OPENAI_API_KEY restent prises en compte comme solution de repli pour la voie de routage auxiliaire provider: "main" ; ne les supprimez donc pas sans vérification si vous les utilisez dans ce cadre.)⁴

Changement d’endpoint personnalisé en cours de session :

/model custom:qwen-2.5             # Custom endpoint with explicit model
/model custom                      # Auto-detect the model from the endpoint
/model custom:local:qwen-2.5       # Named custom provider "local"
/model custom:work:llama3          # Named custom provider "work"
/model openrouter:claude-sonnet-4  # Back to a cloud provider

/model custom (sans nom de modèle) interroge /v1/models sur le API de votre endpoint et sélectionne automatiquement le modèle si un seul est chargé — utile pour les serveurs locaux qui exécutent un modèle unique.²

Serveurs LLM locaux (modèles de configuration)

La documentation officielle propose des guides de configuration complets pour Ollama, vLLM, SGLang, llama.cpp et LM Studio. Voici les principales commandes que vous utiliserez réellement. Chacune est conçue pour produire un endpoint opérationnel vers lequel Hermes peut pointer.²

Ollama — la solution locale la plus simple, sans aucune configuration :

ollama pull qwen2.5-coder:32b
OLLAMA_CONTEXT_LENGTH=32768 ollama serve   # Raise from 4k default
hermes model   # Custom endpoint → http://localhost:11434/v1 → qwen2.5-coder:32b

Piège majeur avec Ollama : par défaut, Ollama utilise des fenêtres de contexte très limitées (4 096 tokens avec moins de 24 Go de VRAM). Vous devez augmenter cette valeur via OLLAMA_CONTEXT_LENGTH ou un Modelfile — le API compatible avec OpenAI n’accepte pas la longueur du contexte transmise par le client ; Hermes ne peut donc pas la définir à votre place.² Pour utiliser un agent, prévoyez au moins 16k–32k.

vLLM — service GPU haute performance :

pip install vllm
vllm serve meta-llama/Llama-3.1-70B-Instruct \
  --port 8000 \
  --max-model-len 65536 \
  --tensor-parallel-size 2 \
  --enable-auto-tool-choice \
  --tool-call-parser hermes

L’appel d’outils nécessite --enable-auto-tool-choice et --tool-call-parser <name>. Analyseurs pris en charge : hermes (Qwen 2.5, Hermes 2/3), llama3_json, mistral, deepseek_v3, deepseek_v31, xlam, pythonic. Sans ces options, les appels d’outils seront renvoyés sous forme de texte brut.²

SGLang — service rapide avec RadixAttention pour réutiliser le cache KV :

pip install "sglang[all]"
python -m sglang.launch_server \
  --model meta-llama/Llama-3.1-70B-Instruct \
  --port 30000 \
  --context-length 65536 \
  --tp 2 \
  --tool-call-parser qwen

Piège avec SGLang : la valeur par défaut de max_tokens est 128. Définissez --default-max-tokens sur le serveur ou configurez model.max_tokens dans config.yaml si les réponses sont tronquées.²

llama.cpp / llama-server — CPU et Metal sur Apple Silicon :

./build/bin/llama-server \
  --jinja -fa \
  -c 32768 \
  -ngl 99 \
  -m models/qwen2.5-coder-32b-instruct-Q4_K_M.gguf \
  --port 8080 --host 0.0.0.0

--jinja est requis pour l’appel d’outils. Sans cette option, llama-server ignore entièrement le paramètre tools et le modèle tente d’appeler des outils en écrivant du JSON dans le texte de sa réponse — que Hermes ne peut pas interpréter comme de véritables appels d’outils.²

LM Studio — application de bureau avec interface graphique :

Démarrez le serveur depuis l’application LM Studio (onglet Developer → Start Server), ou via CLI : lms server start (démarre sur le port 1234) et lms load qwen2.5-coder --context-length 32768.² Faites ensuite pointer hermes model vers http://localhost:1234/v1.

Piège majeur avec LM Studio : LM Studio lit la longueur du contexte dans les métadonnées du modèle, mais de nombreux modèles GGUF indiquent des valeurs par défaut de 2048 ou 4096. Définissez toujours explicitement la longueur du contexte dans les paramètres du modèle LM Studio — cliquez sur l’icône d’engrenage à côté du sélecteur de modèle, réglez « Context Length » sur au moins 16384 (de préférence 32768), puis rechargez le modèle.²

Fournisseurs personnalisés nommés

Si vous utilisez plusieurs endpoints personnalisés (par exemple, un serveur de développement local et un serveur GPU distant), définissez-les comme fournisseurs personnalisés nommés dans config.yaml :²

custom_providers:
  - name: local
    base_url: http://localhost:8080/v1
    # api_key omitted — Hermes uses "no-key-required" for keyless local servers
  - name: work
    base_url: https://gpu-server.internal.corp/v1
    api_key: corp-api-key
    api_mode: chat_completions      # optional, auto-detected from URL
  - name: anthropic-proxy
    base_url: https://proxy.example.com/anthropic
    api_key: proxy-key
    api_mode: anthropic_messages    # for Anthropic-compatible proxies

Vous pouvez ensuite passer de l’un à l’autre en cours de session grâce à la syntaxe triple :

/model custom:local:qwen-2.5
/model custom:work:llama3-70b
/model custom:anthropic-proxy:claude-sonnet-4

Vous pouvez également sélectionner les fournisseurs personnalisés nommés depuis le menu interactif de hermes model.²

Architecture de fournisseurs extensible (v0.13.0+)

La version v0.13.0 fournit une ABC ProviderProfile, ainsi qu’un dossier plugins/model-providers/, afin que des fournisseurs d’inférence tiers puissent être ajoutés sans modifier le cœur du système.¹⁸ Si un fournisseur propose un mode API compatible avec OpenAI, Anthropic ou Codex, vous pouvez implémenter une sous-classe de ProviderProfile qui déclare le parcours d’authentification, l’URL de base, le catalogue de modèles et les en-têtes de mise en cache ; Hermes la résout par le même chemin runtime_provider.py que celui utilisé par les fournisseurs intégrés. C’est le changement architectural à l’origine de l’élargissement des fournisseurs dans la version v0.13.0 : au lieu de modifier le cœur du système pour ajouter un fournisseur, vous distribuez un plugin.

Proxy local compatible avec OpenAI (v0.14.0+)

hermes proxy expose un endpoint local compatible avec OpenAI, adossé au fournisseur OAuth auquel Hermes est déjà connecté — Claude Pro, ChatGPT Pro, SuperGrok ou un autre fournisseur compatible configuré.¹⁹ Ainsi, les outils qui attendent un API de type OpenAI, notamment Codex CLI, Aider, Cline, Continue ou des scripts personnalisés, peuvent réutiliser l’authentification Hermes associée à votre abonnement sans clé API distincte. Considérez le proxy comme une infrastructure de développement locale : choisissez délibérément son adresse d’écoute, ne l’exposez pas largement et tenez compte des conditions propres à chaque fournisseur.

Détection de la longueur du contexte

D’après la documentation officielle, deux paramètres sont constamment confondus :²

• context_length — la fenêtre de contexte totale (budget combiné de tokens d’entrée et de sortie, par exemple 1 000 000 pour Claude Opus 4.7 ou 200 000 pour Sonnet 4.6). Hermes s’en sert pour décider quand compresser l’historique.
• model.max_tokens — la limite de sortie (nombre maximal de tokens que le modèle peut générer dans une seule réponse). Elle est sans rapport avec la longueur de l’historique.

Définissez context_length lorsque la détection automatique détermine une taille de fenêtre incorrecte :

model:
  default: "qwen3.5:9b"
  base_url: "http://localhost:8080/v1"
  context_length: 131072      # tokens

Hermes utilise une chaîne de résolution multisource pour détecter les fenêtres de contexte : remplacement par la configuration → fournisseur personnalisé par modèle → cache persistant → endpoint /models → Anthropic /v1/models → API OpenRouter → Nous Portal → models.dev (registre géré par la communauté pour plus de 3800 modèles) → valeurs par défaut de secours (128K).² Le système tient compte du fournisseur ; un même modèle peut donc avoir des limites de contexte différentes selon le service qui le propose (par exemple, claude-opus-4.6 dispose de 1M directement chez Anthropic, mais de 128K sur GitHub Copilot).²

Routage intelligent des modèles : rotation des fournisseurs et repli

Hermes ne vous limite pas à un seul modèle chez un seul fournisseur. Le routage intelligent des modèles regroupe les mécanismes qui déterminent quel fournisseur et quel modèle traitent effectivement une requête donnée : les pools d’identifiants répartissent la charge entre les clés, un repli configuré prend le relais lorsque le fournisseur principal échoue, et les emplacements auxiliaires ci-dessous acheminent les tâches secondaires vers des modèles moins coûteux, indépendamment de votre modèle principal.²⁶ Configurez ces trois éléments ensemble – ils font la différence entre un agent qui s’arrête lorsqu’il atteint une limite de débit et un agent qui poursuit son travail.

Pools d’identifiants. Lorsque vous disposez de plusieurs clés API pour un même fournisseur, configurez une stratégie de rotation via hermes auth. Vous répartirez ainsi les limites de débit entre plusieurs clés.⁶

Modèle de repli. Configurez une solution de secours provider:model vers laquelle Hermes basculera automatiquement si votre modèle principal échoue (limites de débit, erreurs du serveur, échecs d’authentification) :²

fallback_model:
  provider: openrouter            # required
  model: anthropic/claude-sonnet-4  # required
  # base_url: http://localhost:8000/v1    # optional, for custom endpoints
  # api_key_env: MY_CUSTOM_KEY           # optional, env var name

Le repli change de modèle et de fournisseur en cours de session sans perdre votre conversation. Il ne se déclenche qu’une seule fois au maximum par session.² Fournisseurs pris en charge pour le repli : openrouter, nous, openai-codex, copilot, copilot-acp, anthropic, huggingface, zai, kimi-coding, minimax, minimax-cn, deepseek, ai-gateway, opencode-zen, opencode-go, kilocode, alibaba, custom.²

Modèles auxiliaires

Hermes utilise des modèles « auxiliaires » pour les tâches secondaires : analyse d’images (vision), classification des demandes d’approbation de commandes dangereuses, compression du contexte, génération des titres de session, insertion de balises audio TTS, mise en correspondance des skill, répartition des outils MCP, ainsi que la famille de spécification et de décomposition Kanban.⁴³⁴ Par défaut (auxiliary.*.provider: "auto"), chaque tâche auxiliaire s’exécute sur votre modèle de chat principal – le même fournisseur et le même modèle que vous avez choisis dans hermes model. La documentation indique explicitement que ce comportement remplace l’ancienne détection automatique d’un fournisseur bon marché : « Les versions précédentes orientaient les utilisateurs d’agrégateurs (OpenRouter, Nous Portal) vers un fournisseur par défaut peu coûteux côté fournisseur. Cela créait de la confusion… auto utilise désormais le modèle principal pour tout le monde, tandis que les remplacements par tâche dans config.yaml restent prioritaires. »³⁴ Aucune configuration n’est nécessaire pour commencer ; le compromis concerne le coût – avec les modèles de raisonnement coûteux, les tâches auxiliaires entraînent des dépenses non négligeables. Lorsque cela compte, affectez donc chaque tâche à un modèle rapide et peu coûteux. Deux anciennes tâches auxiliaires n’utilisent désormais plus du tout de LLM : l’extraction web (« web_extract et les instantanés du navigateur tronquent les contenus longs de manière déterministe et stockent le texte intégral afin de permettre sa lecture page par page avec read_file – sans intervention de LLM ») et la recherche de sessions (l’outil à format unique renvoie directement le contenu de la base de données). Leurs anciens blocs auxiliary.web_extract.* et auxiliary.session_search.* ont disparu des paramètres par défaut – les valeurs résiduelles dans un fichier config.yaml existant sont « des vestiges sans conséquence qui sont ignorés » – et l’emplacement flush_memories est lui aussi absent des paramètres par défaut de cette version.³⁴

Vous pouvez configurer le modèle et le fournisseur utilisés par chaque tâche auxiliaire. Chaque emplacement auxiliaire utilise les mêmes paramètres : provider, model, base_url (ainsi que api_key, timeout, extra_body et un paramètre reasoning_effort propre à chaque tâche).⁴³⁴

auxiliary:
  vision:                          # vision_analyze + browser screenshots
    provider: "auto"               # "auto" (= main model), "openrouter", "nous", "main", etc.
    model: ""                      # e.g. "openai/gpt-4o", "google/gemini-2.5-flash"
    base_url: ""                   # Custom OpenAI-compatible endpoint
    api_key: ""                    # Falls back to OPENAI_API_KEY
    timeout: 120
    download_timeout: 30
  approval:                        # dangerous-command approval classifier
    provider: "auto"
    model: ""
    timeout: 30
  compression:                     # summarizer -- legacy compression.summary_* keys migrate here (config v17)
    provider: "auto"
    model: ""
    base_url: ""
    timeout: 120
  title_generation:                # auto-generated session titles after the first exchange
    enabled: true                  # set false to disable auto-titles
    provider: "auto"
    model: ""
    language: ""                   # empty follows the conversation; e.g. "English" pins titles to one language
  tts_audio_tags:    { provider: "auto", model: "" }  # Gemini 3.1 TTS hidden audio-tag insertion
  skills_hub:        { provider: "auto", model: "" }  # skill matching and search
  mcp:               { provider: "auto", model: "" }  # MCP tool dispatch
  triage_specifier:  { provider: "auto", model: "" }  # hermes kanban specify: rough one-liner into a concrete spec, promoted to todo
  kanban_decomposer: { provider: "auto", model: "" }  # hermes kanban decompose: triage task into a graph of child tasks routed to specialist profiles
  profile_describer: { provider: "auto", model: "" }  # hermes profile describe --auto: 1-2 sentence profile descriptions

D’autres emplacements spécialisés suivent la même structure – goal_judge (évalue si le contrat /goal est satisfait), curator (le fork de vérification de l’utilisation des skill), background_review (le fork d’auto-amélioration exécuté après chaque tour), review (le sous-agent chargé de la révision via /review), moa_reference et moa_aggregator (Mixture-of-Agents), memory_query_rewrite, ainsi que monitor – et vous n’avez pas du tout besoin de modifier manuellement YAML : exécutez hermes model, puis choisissez « Configure auxiliary models » afin d’accéder à un sélecteur interactif pour chaque tâche.³⁴

L’option de fournisseur "main" signifie « utiliser le même fournisseur que mon agent principal » – elle est valable uniquement dans auxiliary:, compression: et les entrées de repli principales (fallback_providers:, ou l’ancien fallback_model:). Elle n’est pas valable pour le paramètre de premier niveau model.provider. Si votre modèle principal utilise un endpoint personnalisé compatible avec OpenAI, définissez provider: custom dans votre section model:.⁴

Pourquoi est-ce important ? Puisque auto s’appuie déjà sur votre modèle principal, l’ancien piège selon lequel « il faut configurer OpenRouter, sinon les tâches auxiliaires se dégradent silencieusement » a disparu – le compromis porte désormais sur le coût. Si votre modèle principal est un modèle de raisonnement onéreux, confiez les tâches secondaires gourmandes en échanges à un modèle rapide et bon marché :

auxiliary:
  vision:
    provider: "openrouter"
    model: "google/gemini-2.5-flash"
  compression:
    provider: "openrouter"
    model: "google/gemini-2.5-flash"

Système de configuration

Hermes dispose d’un système de configuration en couches. Il est essentiel d’en comprendre l’ordre de priorité, car les couches supérieures remplacent les couches inférieures, et l’une d’elles est un registre global de fournisseurs qui n’apparaît pas dans config.yaml.

Organisation des fichiers de configuration

Selon la documentation officielle, voici les fichiers qui composent une configuration Hermes :⁴

~/.hermes/
├── config.yaml       # All settings (model, terminal, TTS, compression, memory, toolsets, ...)
├── .env              # Secrets (API keys, bot tokens, passwords)
├── auth.json         # OAuth provider credentials (Nous Portal, Codex, Anthropic)
├── SOUL.md           # Primary agent identity (slot #1 in system prompt)
├── memories/         # Persistent memory (MEMORY.md, USER.md)
├── skills/           # Bundled + agent-created + hub-installed skills
├── cron/             # Scheduled jobs
├── sessions/         # Gateway session state
└── logs/             # agent.log, gateway.log, errors.log (secrets auto-redacted)

config.yaml ou .env — lorsque les deux définissent un même paramètre, config.yaml l’emporte pour les paramètres non secrets.⁴ La règle est la suivante : - Secrets (clés API, tokens de bots, mots de passe) → .env - Tout le reste (modèle, backend du terminal, paramètres de compression, limites de mémoire, toolsets) → config.yaml

Les secrets peuvent être référencés depuis config.yaml à l’aide d’une interpolation de type shell :⁴

auxiliary:
  vision:
    api_key: ${GOOGLE_API_KEY}
    base_url: ${CUSTOM_VISION_URL}
  delegation:
    api_key: ${DELEGATION_KEY}

Gestion de la configuration

hermes config                # View current configuration
hermes config show           # Same as above
hermes config edit           # Open config.yaml in your editor
hermes config set KEY VAL    # Set a specific value
hermes config get KEY        # Print a single value (v0.19.0+)
hermes config unset KEY      # Remove a key so the default applies again (v0.19.0+)
hermes config path           # Print the config file path
hermes config env-path       # Print the .env file path
hermes config check          # Check for missing options (after updates)
hermes config migrate        # Interactively add missing options

Exemples :⁴

hermes config set model anthropic/claude-opus-4
hermes config set terminal.backend docker
hermes config set OPENROUTER_API_KEY sk-or-...   # Saves to .env

hermes config check et hermes config migrate sont les commandes à exécuter après chaque hermes update : elles détectent les nouvelles options de configuration qui ne figurent pas encore dans votre fichier.⁶

Ordre de priorité de la configuration

Hermes charge la configuration depuis plusieurs sources. Lorsque plusieurs sources définissent la même valeur, celle qui a la priorité la plus élevée l’emporte :⁴

1. Arguments CLI — hermes chat --model anthropic/claude-sonnet-4 (remplacement pour une seule exécution)
2. Variables d’environnement — appliquées au démarrage du processus
3. config.yaml — le fichier de paramètres principal
4. .env — secrets uniquement
5. Valeurs par défaut intégrées — appliquées lorsqu’aucune autre source ne définit de valeur

Les options CLI l’emportent toujours pour l’exécution concernée. config.yaml constitue la source de référence à long terme.

Localisation (v0.13.0+)

La version v0.13.0 a ajouté 7 langues pour les messages de CLI et du gateway : chinois (simplifié), japonais, allemand, espagnol, français, ukrainien et turc.¹⁸ La version v0.14.0 traduit toutes les commandes du gateway ainsi que le tableau de bord web, ajoute 8 langues supplémentaires et porte leur nombre total à 16.¹⁹ Dans le tag v2026.8.31, l’arborescence locales/ contient 17 catalogues de messages – l’anglais et 16 traductions (af, ar, de, es, fr, ga, hu, it, ja, ko, pt, ru, tr, uk, zh-hant, zh).³³ À l’heure actuelle, la documentation n’est traduite qu’en zh-Hans. La langue est déterminée à partir des variables d’environnement LC_ALL / LANG ou d’une clé locale: explicite dans config.yaml. L’anglais reste la langue par défaut et la source de référence pour toute chaîne qui n’a pas encore été traduite.

Profiles — plusieurs instances Hermes isolées

Les profiles vous permettent de disposer de plusieurs instances Hermes isolées, chacune avec sa propre configuration, ses propres sessions, skills, sa propre mémoire et son propre PID de gateway. Vous pouvez ainsi exécuter côte à côte un « Hermes professionnel » et un « Hermes personnel » sans que l’un puisse accéder à l’état de l’autre.⁶

hermes profile list
hermes profile create work --clone                  # Clone from current profile
hermes profile use work                             # Set sticky default
hermes profile alias work --name h-work             # Create wrapper script
hermes profile export work -o work-backup.tar.gz
hermes profile import work-backup.tar.gz --name restored
hermes -p work chat -q "Hello from work profile"    # One-off without switching

Chaque profile dispose de son propre HERMES_HOME (~/.hermes-<name>/ par défaut), ce qui permet à plusieurs profiles d’exécuter simultanément le gateway sans interférer les uns avec les autres.⁶³

Depuis la version v0.21.2, la frontière d’isolation est renforcée : un ensemble de correctifs a éliminé de véritables fuites entre profiles dans les configurations avec gateway multiplexé, où des profiles secondaires pouvaient hériter des listes d’autorisation du profile par défaut, envoyer des identifiants à son hôte, transmettre les secrets de son coffre-fort à des serveurs MCP stdio ou joindre les fichiers .env/auth.json/state.db d’un autre profile à un envoi MEDIA: (#107609-#107630). Si vous multiplexez des profiles, le tag v0.21.2 est celui à partir duquel l’isolation annoncée est effectivement garantie – consultez Nouveautés de la version v0.21.2.⁴⁸

Commandes CLI

Cette section constitue la référence pratique des commandes CLI de premier niveau. Pour consulter la référence officielle issue du code, reportez-vous à la référence des commandes CLI.⁶

Options globales

hermes [global-options] <command> [subcommand/options]

Commandes de premier niveau

hermes chat — Le point d’entrée principal

Exécuté sans argument, hermes ouvre une conversation interactive. hermes chat en est la forme explicite, avec les options suivantes :⁶

hermes chat -q "Summarize the latest PRs" --oneshot # Answer and exit (without --oneshot, a TTY seeds an interactive session)
hermes chat --provider openrouter --model anthropic/claude-sonnet-4.6
hermes chat --toolsets web,terminal,skills          # Enable specific toolsets
hermes chat --quiet -q "Return only JSON"           # Programmatic mode
hermes chat --worktree -q "Review repo and open a PR"

Options principales :

hermes setup — Assistant complet

Exécute l’assistant de configuration complet ou ouvre directement l’une de ses sections :⁶

hermes setup                 # Full wizard
hermes setup model           # Provider and model only
hermes setup terminal        # Terminal backend only
hermes setup gateway         # Messaging platforms only
hermes setup tools           # Tool enable/disable per platform
hermes setup agent           # Agent behavior only
hermes setup --non-interactive
hermes setup --reset         # Reset config to defaults before setup

hermes logs — Interrogation structurée des journaux

hermes logs est plus puissant que tail -f sur les fichiers journaux, car il permet de filtrer simultanément par niveau, ID de session et plage temporelle.⁶

hermes logs                          # Last 50 lines of agent.log
hermes logs -f                       # Follow in real time
hermes logs gateway -n 100           # Last 100 lines of gateway.log
hermes logs --level WARNING --since 1h   # Warnings from the last hour
hermes logs --session abc123         # Filter by session ID substring
hermes logs errors --since 30m -f    # Follow errors.log from 30m ago
hermes logs list                     # List all log files with sizes

Les fichiers journaux se trouvent dans ~/.hermes/logs/ :⁶ - agent.log — toute l’activité de l’agent (appels API, dispatch d’outils, cycle de vie des sessions, niveau INFO et supérieur) - errors.log — avertissements et erreurs uniquement (sous-ensemble filtré de agent.log) - gateway.log — activité du gateway de messagerie (connexions aux plateformes, dispatch, webhooks)

La rotation est automatique grâce au RotatingFileHandler de Python — recherchez agent.log.1, agent.log.2, etc.⁶

hermes doctor — Diagnostics

hermes doctor [--fix] est la première commande à exécuter lorsqu’un problème survient. Elle vérifie la validité de la configuration, la présence des dépendances, la disponibilité des clés API et l’état des services, puis peut tenter des réparations automatiques avec --fix.⁶

Pour partager les diagnostics avec quelqu’un, utilisez hermes dump — cette commande produit un résumé compact en texte brut, avec les clés API masquées, prêt à être collé dans une issue GitHub ou une discussion Discord.⁶

Commandes slash

Les commandes slash s’exécutent au sein d’une session de chat active (CLI ou plateforme de messagerie). Elles sont distribuées depuis un COMMAND_REGISTRY partagé dans hermes_cli/commands.py, ce qui explique pourquoi la plupart fonctionnent de manière identique sur toutes les interfaces.⁹

Contrôle de la session

Configuration et modèle

La commande /model est l’outil principal pour changer de fournisseur en cours de session :⁹

/model                              # Show current model and options
/model claude-sonnet-4              # Switch model (auto-detect provider)
/model zai:glm-5                    # Switch provider:model
/model custom:qwen-2.5              # Use model on custom endpoint
/model custom                       # Auto-detect model from custom endpoint
/model custom:local:qwen-2.5        # Named custom provider
/model openrouter:anthropic/claude-sonnet-4   # Back to cloud

La v0.19.0 ajoute /model --once — un changement de modèle limité à un seul tour, avec retour automatique au modèle précédent après la réponse.⁵⁶ Depuis la période de la v0.20.5, le sélecteur /model propose également une recherche approximative : il filtre les résultats à mesure que vous saisissez du texte.²³³⁵

Outils, skills et informations

Commandes slash dynamiques des skills

Chaque skill installé est automatiquement exposé sous forme de commande slash :⁹

/gif-search funny cats
/axolotl help me fine-tune Llama 3 on my dataset
/github-pr-workflow create a PR for the auth refactor
/excalidraw       # Just the skill name loads it and lets the agent ask what you need

Depuis la v0.19.0, les appels de skills par commande slash se cumulent : /skill-a /skill-b do XYZ charge les deux skills dans l’ordre au cours d’un même tour, avec autocomplétion et texte fantôme pour les noms enchaînés.⁵⁶

Vous pouvez également définir dans config.yaml des commandes rapides qui associent un nom court à un prompt plus long :⁹

quick_commands:
  review: "Review my latest git diff and suggest improvements"
  deploy: "Run the deployment script at scripts/deploy.sh and verify the output"
  morning: "Check my calendar, unread emails, and summarize today's priorities"

Saisissez ensuite /review, /deploy ou /morning dans CLI.

Correspondance par préfixe

Les commandes prennent en charge la correspondance par préfixe : la saisie de /h correspond à /help, tandis que /mod correspond à /model. Lorsqu’un préfixe est ambigu, le premier enregistrement selon l’ordre du registre l’emporte. Les noms complets des commandes et les alias enregistrés sont toujours prioritaires sur les correspondances par préfixe.⁹

Commandes propres aux plateformes de messagerie

Certaines commandes fonctionnent uniquement sur les plateformes de messagerie (Telegram, Discord, Slack, WhatsApp, Signal, Email, Home Assistant) :⁹

• /status — afficher les informations sur la session (cette commande n’est plus réservée aux plateformes de messagerie ; consultez Contrôle de la session)
• /sethome (alias /set-home) — définir le chat actuel comme accueil de la plateforme
• /approve [session|always] — approuver une commande dangereuse en attente
• /deny [reason] — refuser une commande dangereuse en attente. Depuis la v0.19.0, /deny <reason> transmet le motif de votre refus à l’agent afin qu’il rectifie son approche au lieu de réessayer à l’aveugle⁵⁶
• /update — mettre à jour Hermes Agent vers la dernière version
• /commands [page] — parcourir toutes les commandes et tous les skills (avec pagination)

D’autres sont réservées à CLI : /skin, /tools, /toolsets, /browser, /config, /cron, /skills, /platforms, /paste, /statusbar, /plugins.⁹

Outils et toolsets

Hermes intègre un vaste registre d’outils couvrant la recherche sur le Web, l’automatisation du navigateur, l’exécution dans le terminal, la modification de fichiers, la mémoire, la délégation, l’entraînement par renforcement, l’envoi de messages, l’intégration à Home Assistant et bien plus encore.¹⁰ Les outils sont organisés en toolsets logiques qui peuvent être activés ou désactivés pour chaque plateforme.

Catégories principales

Les noms courants de toolsets comprennent web, terminal, file, browser, vision, image_gen, moa, skills, tts, todo, memory, session_search, cronjob, code_execution, delegation, clarify, homeassistant et rl.¹⁰

Gestion des outils

hermes chat --toolsets "web,terminal"       # Use specific toolsets
hermes tools                                # Interactive per-platform tool config
hermes tools --summary                      # Print enabled-tools summary

Les outils peuvent également être activés ou désactivés en cours de session avec /tools disable <name> et /tools enable <name>, ce qui réinitialise la session afin que le nouvel ensemble d’outils soit pris en compte.⁹

Backends de terminal

L’outil de terminal intègre 7 backends d’exécution et, depuis la v0.20.6, cet ensemble est extensible au moyen de plugins, comme le sélecteur de fournisseurs (voir ci-dessous) :¹⁰²⁴

Changez de backend avec hermes config set terminal.backend <name> ou dans config.yaml :

terminal:
  backend: docker      # or: local, ssh, singularity, modal, daytona, vercel_sandbox
  cwd: "."             # Working directory
  timeout: 180         # Command timeout in seconds

Backends de plugins (v0.20.6+). Les fournisseurs tiers d’environnements isolés n’ont plus besoin d’intégrer le dépôt principal : un plugin enregistre un TerminalEnvironmentProvider au chargement via PluginContext.register_terminal_environment_provider, puis le nom enregistré peut être sélectionné dans terminal.backend exactement comme celui d’un backend intégré. Les noms intégrés sont réservés — le registre refuse tout fournisseur dont le nom entre en conflit avec un backend présent dans le dépôt — et un backend enregistré est automatiquement pris en charge par toutes les interfaces principales (sélecteur de backend de hermes setup, état des sondes dans le tableau de bord, vérifications de hermes doctor, gestion des chemins et du répertoire de travail dans les conteneurs, suppression des secrets), car le cœur consulte le registre à chaque point de classification au lieu d’utiliser une liste de noms codée en dur.³²

Backend SSH (recommandé pour des raisons de sécurité — l’agent ne peut pas modifier son propre code) :¹⁰

terminal:
  backend: ssh

# In ~/.hermes/.env
TERMINAL_SSH_HOST=my-server.example.com
TERMINAL_SSH_USER=myuser
TERMINAL_SSH_KEY=~/.ssh/id_rsa

Backend Docker :

terminal:
  backend: docker
  docker_image: python:3.11-slim

Ressources des conteneurs (s’applique à docker, singularity, modal et daytona) :¹⁰

terminal:
  container_cpu: 1
  container_memory: 5120          # MB (default 5GB)
  container_disk: 51200           # MB (default 50GB)
  container_persistent: true      # Persist filesystem across sessions

Avec container_persistent: true, les paquets installés, les fichiers et la configuration sont conservés d’une session à l’autre.¹⁰

Tous les backends de conteneurs appliquent un renforcement de la sécurité : système de fichiers racine en lecture seule (Docker), suppression de toutes les capacités Linux à l’exception de DAC_OVERRIDE, CHOWN et FOWNER, interdiction de l’élévation de privilèges, limites de PID (256 processus), isolation complète des espaces de noms et espace de travail persistant au moyen de volumes.¹⁰

Processus en arrière-plan

L’outil de terminal prend en charge l’exécution en arrière-plan avec une gestion explicite des processus :¹⁰

terminal(command="pytest -v tests/", background=true)
# Returns: {"session_id": "proc_abc123", "pid": 12345}

process(action="list")                            # Show all running processes
process(action="poll", session_id="proc_abc123")  # Check status
process(action="wait", session_id="proc_abc123")  # Block until done
process(action="log", session_id="proc_abc123")   # Full output
process(action="kill", session_id="proc_abc123")  # Terminate
process(action="write", session_id="proc_abc123", data="y")  # Send input

Le mode PTY (pty=true) permet d’utiliser des outils interactifs CLI tels que Codex et Claude Code.¹⁰

Sudo

Si une commande nécessite sudo, Hermes vous demande votre mot de passe, qui est mis en cache pour la durée de la session. Vous pouvez également définir SUDO_PASSWORD dans ~/.hermes/.env.¹⁰

Kanban multi-agent (v0.13.0+)

La v0.13.0 fait de la collaboration multi-agent un mécanisme de premier ordre : un tableau Kanban persistant qui suit les tâches, leur état et l’identité des workers d’un agent à l’autre et après les redémarrages.¹⁸ C’est ce tableau qui permet à un essaim de workers Hermes de réellement terminer son travail au lieu de rester bloqué à cause de relais interrompus.

Le tableau Kanban s’associe naturellement à /goal (boucle Ralph avec objectif verrouillé) pour définir la cible, ainsi qu’à l’outil delegate_task existant pour la création de workers. Il en résulte un modèle d’essaim dans lequel chaque agent partage une source de vérité unique indiquant la prochaine tâche à accomplir, la personne qui s’en charge et les éventuels blocages.

Qu’est-ce qu’un essaim Hermes ?

Un essaim regroupe plusieurs workers Hermes exécutés en parallèle à partir d’un même tableau Kanban. Ce n’est pas un sous-système distinct à activer — c’est ce que le tableau rend possible. Celui-ci fournit l’unique élément que des agents parallèles ne peuvent pas produire eux-mêmes : une réponse unique faisant autorité à la question que dois-je prendre en charge ensuite, et quelqu’un s’en occupe-t-il déjà ?

La v0.15.0 a fait de ce modèle une topologie officiellement prise en charge en ajoutant une topologie d’essaim pour la coordination de workers parallèles, la décomposition automatique d’un objectif général en sous-tâches, le remplacement du modèle par tâche, les tâches planifiées et la gestion des worktrees, afin que les workers parallèles ne se gênent pas dans le même checkout.⁵⁹

En pratique : donnez un objectif à l’essaim, laissez la décomposition automatique le convertir en tâches sur le tableau, puis laissez les workers les réclamer, les exécuter et renvoyer leurs résultats. Le nombre maximal de nouvelles tentatives est défini par tâche (max_retries), afin qu’une seule sous-tâche fragile n’épuise pas la tolérance de toute l’exécution. Grâce à la persistance du tableau, un essaim survit aux redémarrages — les workers se reconnectent et reprennent leur travail à partir du même état.

La qualité d’un essaim dépend de sa décomposition. Le tableau coordonne les workers ; il ne transforme pas un objectif mal découpé en un bon objectif. Les tâches qui partagent un état caché continueront d’entrer en conflit, avec ou sans worktrees.

Système de skills

Les skills sont des documents de connaissances à la demande que l’agent peut charger lorsqu’il en a besoin. Ils suivent un modèle de divulgation progressive afin de réduire au minimum l’utilisation de tokens et sont compatibles avec le standard ouvert agentskills.io.¹¹

Tous les skills se trouvent dans ~/.hermes/skills/ — le dossier principal et la source de vérité. Lors d’une nouvelle installation, les skills inclus sont copiés depuis le dépôt. Les skills installés depuis un hub et ceux créés par l’agent y sont également stockés.¹¹

Divulgation progressive

Level 0: skills_list()           → [{name, description, category}, ...]   (~3k tokens)
Level 1: skill_view(name)        → Full content + metadata                 (varies)
Level 2: skill_view(name, path)  → Specific reference file                 (varies)

L’agent ne charge le contenu complet du skill que lorsqu’il en a réellement besoin.¹¹

Format SKILL.md

---
name: my-skill
description: Brief description of what this skill does
version: 1.0.0
platforms: [macos, linux]      # Optional — restrict to OS platforms
metadata:
  hermes:
    tags: [python, automation]
    category: devops
    fallback_for_toolsets: [web]     # Conditional activation
    requires_toolsets: [terminal]    # Conditional activation
    config:                          # Config.yaml settings
      - key: my.setting
        description: "What this controls"
        default: "value"
        prompt: "Prompt for setup"
---

# Skill Title

## When to Use
Trigger conditions for this skill.

## Procedure
1. Step one
2. Step two

## Pitfalls
- Known failure modes and fixes

## Verification
How to confirm it worked.

Activation conditionnelle

Les skills peuvent s’afficher ou se masquer selon les outils disponibles. Cette fonctionnalité est particulièrement utile pour les skills de secours — des solutions gratuites ou locales qui ne doivent apparaître que lorsqu’un outil premium est indisponible :¹¹

Exemple : le skill intégré duckduckgo-search utilise fallback_for_toolsets: [web]. Lorsque FIRECRAWL_API_KEY est défini, le toolset web est disponible et l’agent utilise web_search — le skill DuckDuckGo reste masqué. Sans la clé API, le skill DuckDuckGo apparaît automatiquement comme solution de secours.¹¹

Skills gérés par l’agent

L’agent peut créer, mettre à jour et supprimer ses propres skills à l’aide de l’outil skill_manage. Il s’agit de la mémoire procédurale de l’agent — lorsqu’il met au point un workflow complexe, il enregistre la méthode sous forme de skill afin de pouvoir la réutiliser ultérieurement.¹¹

Quand l’agent crée des skills :¹¹ - Après avoir mené à bien une tâche complexe (au moins 5 appels d’outils) - Lorsqu’il a rencontré des erreurs ou des impasses avant de trouver la bonne méthode - Lorsque l’utilisateur a corrigé son approche - Lorsqu’il a découvert un workflow complexe

Actions :¹¹

Hub de skills

Parcourez, recherchez, installez et gérez des skills provenant de registres en ligne :⁶¹¹

hermes skills browse                          # Browse all hub skills
hermes skills browse --source official        # Browse official optional skills
hermes skills search kubernetes               # Search all sources
hermes skills search react --source skills-sh # Search skills.sh directory
hermes skills inspect openai/skills/k8s       # Preview before installing
hermes skills install openai/skills/k8s       # Install with security scan
hermes skills install skills-sh/anthropics/skills/pdf --force
hermes skills check                           # Check for upstream updates
hermes skills update                          # Reinstall changed hub skills
hermes skills audit                           # Re-scan installed hub skills
hermes skills uninstall k8s
hermes skills publish skills/my-skill --to github --repo owner/repo
hermes skills tap add myorg/skills-repo       # Add custom GitHub source

Sources de hub intégrées :¹¹

Taps GitHub par défaut (consultables sans configuration) : openai/skills, anthropics/skills, huggingface/skills, NVIDIA/skills, garrytan/gstack. La source claude-marketplace a été supprimée dans la version v0.20.0 ; browse-sh l’a remplacée dans la liste des sources.¹¹⁵⁵

Analyse de sécurité

Tous les skills installés depuis un hub passent par un scanner de sécurité qui recherche les exfiltrations de données, les injections de prompt, les commandes destructrices, les signaux liés à la chaîne d’approvisionnement et d’autres menaces.¹¹

Niveaux de confiance :¹¹

--force permet de contourner les blocages de politique non dangereux pour les skills communautaires. Cette option ne permet pas de contourner un verdict d’analyse dangerous.¹¹

Dossiers de skills externes

Vous pouvez indiquer à Hermes des dossiers de skills supplémentaires à analyser en parallèle du dossier local :¹¹

skills:
  external_dirs:
    - ~/.agents/skills
    - /home/shared/team-skills
    - ${SKILLS_REPO}/skills

Les chemins prennent en charge le développement de ~ et la substitution des variables d’environnement ${VAR}. Les dossiers externes sont en lecture seule — lorsque l’agent crée ou modifie un skill, il écrit toujours dans ~/.hermes/skills/. La version locale est prioritaire si un skill portant le même nom existe aux deux endroits.¹¹

Skills épinglés : skills.auto_load (période de la v0.21.4)

Les noms de skills indiqués sous skills.auto_load dans config.yaml sont épinglés et entièrement chargés dans chaque nouvelle session – CLI, TUI, gateway, cron et API inclus :⁵¹

skills:
  auto_load:
    - team-conventions
    - deploy-checklist

La liste n’est résolue qu’une seule fois, lors de la première génération du prompt de l’agent ; un nom manquant ou désactivé déclenche un avertissement et est ignoré au lieu de faire échouer la session, tandis que HERMES_IGNORE_RULES (le mécanisme sous-jacent à --ignore-rules) supprime cette liste comme le reste du contexte injecté automatiquement. C’est le complément permanent de -s/--skills, qui précharge des skills pour une seule session.⁵¹

Mémoire persistante

Hermes dispose d’une mémoire limitée et organisée qui persiste d’une session à l’autre. Deux fichiers constituent la mémoire de l’agent, tous deux stockés dans ~/.hermes/memories/ :¹²

Tous deux sont injectés dans le prompt système sous forme d’instantané figé au début de la session. L’agent gère sa propre mémoire avec l’outil memory — add, replace ou remove.¹²

Principe de l’instantané figé : l’injection dans le prompt système est capturée une seule fois au début de la session et ne change jamais en cours de session. Ce comportement est intentionnel : il préserve le cache de préfixe du LLM pour améliorer les performances. Les modifications effectuées pendant une session sont immédiatement enregistrées sur le disque, mais n’apparaissent dans le prompt système qu’à la session suivante.¹²

Éléments à enregistrer

À enregistrer (l’agent le fait de manière proactive) :¹² - Préférences de l’utilisateur : « Je préfère TypeScript à JavaScript » → user - Informations sur l’environnement : « Ce serveur utilise Debian 12 avec PostgreSQL 16 » → memory - Corrections : « N’utilisez pas sudo pour les commandes Docker, l’utilisateur appartient au groupe docker » → memory - Conventions : « Le projet utilise des tabulations, des lignes de 120 caractères et des docstrings de style Google » → memory - Travail terminé : « Migration de la base de données de MySQL vers PostgreSQL le 15 janvier 2026 » → memory

À ignorer :¹² - Informations triviales ou évidentes - Informations faciles à retrouver - Dumps de données brutes (trop volumineux pour la mémoire) - Éléments éphémères propres à la session - Informations déjà présentes dans les fichiers de contexte

Recherche dans les sessions

Au-delà de MEMORY.md et USER.md, l’agent peut rechercher dans ses conversations passées avec l’outil session_search. Toutes les sessions CLI et de messagerie sont stockées dans SQLite (~/.hermes/state.db) avec la recherche en texte intégral FTS5. Depuis la refonte de la v0.15.0, l’outil ne fait plus du tout appel à un LLM : il renvoie directement le contenu des conversations stockées (selon la formulation de la source, le « single-shape tool returns DB content directly »), ce qui l’a rendu 4 500 fois plus rapide et a supprimé son coût en API.¹²⁵⁹³⁴

Deux ajouts de la période v0.21.4, tous deux vérifiés avec le tag v2026.9.21. Premièrement, les limites temporelles : la forme de découverte accepte after (limite inférieure inclusive de l’heure de début de la session) et before (limite supérieure exclusive), chacun pouvant être une date ou une date-heure ISO — une valeur ne contenant qu’une date correspond à minuit UTC ce jour-là — ou une durée relative (7d, 24h, 2w). Ces paramètres sont réservés aux requêtes qui mentionnent réellement une période ; sort reste un biais de classement, et non une limite. Deuxièmement, une nouvelle tentative de rappel en l’absence de résultat : comme FTS5 applique implicitement un opérateur AND entre les termes, une requête reformulée comportant plusieurs mots peut ne pas retrouver une phrase enregistrée s’il lui manque ne serait-ce qu’un de ces mots. Par conséquent, lorsque la requête exacte et toutes les recherches de sous-chaînes ne donnent aucun résultat, la recherche interroge à nouveau l’index en acceptant N’IMPORTE QUEL terme, puis classe en premier les lignes qui couvrent le plus de termes. Les résultats conservent la sémantique de correspondance exacte (la nouvelle tentative n’a lieu qu’après une recherche sans résultat), tandis que les requêtes comportant explicitement OR/NOT, celles ne contenant qu’un terme et celles orientées vers le traitement CJK restent inchangées.⁵¹

Fournisseurs de mémoire externes

Pour disposer d’une mémoire persistante plus approfondie que MEMORY.md et USER.md, Hermes inclut sept plugins de fournisseurs de mémoire externes : Honcho, OpenViking, Mem0, Holographic, RetainDB, ByteRover et Supermemory. D’autres, tels que Hindsight, s’installent depuis le catalogue de plugins.¹²

Hindsight faisait partie du code source principal jusqu’à la v0.21.4, puis a été transféré dans le catalogue avec la v0.21.5, sous la maintenance de Vectorize. Les installations existantes migrent automatiquement : si memory.provider: hindsight est défini, hermes update installe le plugin du catalogue dans le dossier personnel de chaque profile qui le référence, et le premier démarrage de l’agent l’installe s’il est toujours absent. Avec security.allow_lazy_installs: false, le démarrage de l’agent se contente de consigner un message ; exécutez donc vous-même hermes plugins install hindsight. Le plugin est installé dans ~/.hermes/plugins/hindsight/ et ajouté à plugins.enabled ; memory.provider, memory.hindsight.*, HINDSIGHT_API_KEY et vos données en mémoire restent inchangés. Vérifiez l’installation avec hermes memory status et hermes plugins list. L’extra pip hermes-agent[hindsight] a été supprimé.⁵³

Les fournisseurs externes fonctionnent en parallèle de la mémoire intégrée (sans jamais la remplacer) et ajoutent des fonctionnalités telles que les graphes de connaissances, la recherche sémantique, l’extraction automatique de faits et la modélisation de l’utilisateur entre les sessions :⁶¹²

hermes memory setup         # Pick a provider and configure it
hermes memory status        # Check what's active
hermes memory off           # Disable external provider (built-in only)

Un seul fournisseur externe peut être actif à la fois. La mémoire intégrée reste toujours active.⁶

Reprise automatique des sessions (v0.13.0+)

La v0.13.0 permet de survivre à une interruption en cours d’exécution de l’agent. Le gateway reprend automatiquement les sessions interrompues après un redémarrage ; les redémarrages déclenchés par /update conservent l’état de la session pendant la mise à niveau ; pendant le développement, le rechargement des fichiers sources maintient la session active au lieu d’en imposer une nouvelle.¹⁸ Conséquence concrète : les tâches de longue durée du gateway et les jobs pilotés par cron ne réinitialisent plus leur fenêtre de contexte au redémarrage du processus.

Checkpoints v2 (v0.13.0+)

Dans la v0.13.0, la persistance de l’état est réécrite selon une architecture à stockage unique, avec un véritable élagage, des garde-fous pour le disque et aucun dépôt fantôme orphelin.¹⁸ L’ancien système de checkpoint accumulait l’état sur le disque pour les profiles de longue durée ; le stockage v2 impose un plafond strict à l’espace local consacré aux checkpoints et supprime la comptabilité dupliquée à l’origine de cette croissance. Aucune modification de la configuration par l’utilisateur n’est nécessaire ; la prochaine écriture d’un checkpoint utilisera le chemin v2.

Personnalité et SOUL.md

SOUL.md constitue l’identité principale d’une instance Hermes. Il occupe l’emplacement nº 1 du prompt système et remplace l’identité par défaut inscrite en dur.¹³

Hermes crée automatiquement un fichier SOUL.md par défaut dans ~/.hermes/SOUL.md (ou $HERMES_HOME/SOUL.md pour les profiles personnalisés). Les fichiers existants de l’utilisateur ne sont jamais écrasés. Hermes charge uniquement SOUL.md depuis HERMES_HOME — il ne le recherche pas dans le répertoire de travail actuel. La personnalité reste ainsi prévisible d’un projet à l’autre.¹³

Contenu à placer dans SOUL.md

Utilisez-le pour définir durablement la voix et la personnalité :¹³ - ton - style de communication - degré de franchise - style d’interaction par défaut - éléments stylistiques à éviter - manière dont Hermes doit gérer l’incertitude, le désaccord et l’ambiguïté

Utilisez-le moins pour :¹³ - les instructions ponctuelles propres à un projet - les chemins de fichiers - les conventions du dépôt - les détails temporaires du workflow

Ces éléments ont leur place dans AGENTS.md, et non dans SOUL.md.

SOUL.md ou AGENTS.md

Il s’agit de la distinction la plus importante dans la gestion de l’identité de Hermes :¹³

SOUL.md — identité, ton, style, paramètres de communication par défaut et comportement lié à la personnalité.

AGENTS.md — architecture du projet, conventions de code, préférences d’outils, workflows propres au dépôt, commandes, ports, chemins et notes de déploiement.

Une règle pratique : si un élément doit vous suivre partout, il a sa place dans SOUL.md. S’il est propre à un projet, il a sa place dans AGENTS.md.¹³

Personnalités intégrées

Hermes inclut des personnalités intégrées que vous pouvez sélectionner avec /personality :¹³³³

Personnalités personnalisées dans config.yaml :¹³

agent:
  personalities:
    codereviewer: >
      You are a meticulous code reviewer. Identify bugs, security issues,
      performance concerns, and unclear design choices. Be precise and constructive.

Sélectionnez ensuite cette personnalité avec /personality codereviewer.

SOUL.md ou /personality

SOUL.md définit la voix de référence. /personality applique une surcouche au niveau de la session.¹³ Conservez un fichier SOUL.md pragmatique par défaut, puis utilisez /personality teacher pour une conversation pédagogique ou /personality creative pour une séance de brainstorming.

Nous Tool Gateway (v0.10.0+)

Depuis Hermes Agent v0.10.0 (16 avril 2026), les abonnés payants à Nous Portal bénéficient d’un accès géré à une sélection d’outils grâce à leurs identifiants Portal existants, sans avoir à gérer de clés API supplémentaires.⁶¹ Le CLI Hermes lui-même reste sous licence MIT et entièrement open source. Ce qui change, c’est que votre authentification Portal donne désormais accès à bien plus que l’inférence de modèles.

Le moyen le plus rapide de commencer est hermes setup --portal, que le README présente comme « Une seule commande après une nouvelle installation » : cette commande vous connecte via OAuth, définit Nous comme fournisseur et active le Tool Gateway. Ensuite, hermes portal permet de gérer cette intégration. hermes portal login (la commande par défaut lorsqu’aucune sous-commande n’est indiquée) lance la même configuration initiale en une seule étape ; hermes portal info affiche le « récapitulatif de l’authentification Portal et du routage du Tool Gateway » ; hermes portal open ouvre la page d’abonnement dans votre navigateur par défaut ; hermes portal tools répertorie les outils du gateway et indique ceux qui sont acheminés via Nous. hermes portal status subsiste en tant qu’alias masqué et rétrocompatible de info, tandis que la documentation de référence du CLI associée au tag utilise encore la sous-commande status : les deux fonctionnent donc.²⁸

Contenu du gateway

Fonctionnement

Le gateway s’active outil par outil grâce à un nouveau champ de configuration use_gateway. Si vous disposez d’identifiants Portal dans hermes auth et activez le gateway pour un outil, les appels de cet outil sont acheminés via Portal. Dans le cas contraire, votre clé API directe est utilisée, si elle est présente.

# config.yaml — per-tool gateway opt-in
tools:
  web_search:
    provider: firecrawl
    use_gateway: true          # route via Nous Portal subscription
  image_generation:
    provider: fal
    use_gateway: true

Ordre de priorité à l’exécution : lorsque le gateway est disponible et que use_gateway: true est défini pour un outil, Hermes privilégie le gateway même si vous avez également configuré une clé API directe. Ce comportement a une incidence sur la facturation : les appels au gateway sont décomptés de votre abonnement Portal, et non du solde associé à votre clé API directe.

Activation du gateway

hermes model                      # select Nous Portal (OAuth flow)
hermes tools                      # per-platform tool picker integrates gateway tools
hermes status                     # confirms gateway/subscription detection

L’abonnement est détecté automatiquement à partir des identifiants OAuth Portal déjà enregistrés dans hermes auth : aucune connexion distincte n’est nécessaire. Depuis la v0.19.0, vous pouvez également gérer l’abonnement directement depuis une session : /subscription affiche votre formule et votre quota restant, indique précisément le coût d’un passage à une formule supérieure ou la date de prise d’effet d’un passage à une formule inférieure, puis applique la modification en affichant des bannières signalant le changement programmé et en permettant de l’annuler ; /topup ajoute du crédit. L’application de bureau propose un onglet de paramètres de facturation équivalent.⁵⁶

Tarification et accès

Les tarifs et les noms des formules sont publiés sur la page de tarification de Nous Portal (https://portal.nousresearch.com/pricing). Ce guide ne les détaille pas, car ils relèvent du produit Portal, et non du CLI Hermes, et évoluent indépendamment des versions de Hermes. Inscrivez-vous sur https://portal.nousresearch.com/ et consultez la page de tarification pour connaître les formules actuelles.

Formule gratuite de Nous et premier lancement guidé (v0.21.2+)

Depuis la v0.21.2, une nouvelle installation ne nécessite ni formule payante ni clé API pour obtenir un agent fonctionnel : l’inférence gratuite et les connecteurs sont disponibles immédiatement, avec une seule commande pour vous connecter, tandis que /login lance la connexion depuis une conversation. Les outils des connecteurs (Gmail, Linear, Notion et les autres) peuvent être recherchés au moyen de tool_search, comme n’importe quel autre outil. L’application de bureau propose un premier lancement guidé contrôlé par HERMES_GUEST_ONBOARDING=1 ; seule la valeur littérale 1 l’active — le test propre à l’application de bureau vérifie que 'true', '0' et une valeur vide le laissent tous désactivé, et la décision prise au lancement est inscrite dans l’environnement du backend démarré afin qu’une valeur héritée ne puisse jamais s’y propager.⁴⁸

Depuis la période de sortie de la v0.21.4, la connexion de ces connecteurs relève d’une seule opération gérée par le backend, plutôt que d’une logique dispersée entre les différents frontends : un appel à l’outil manage_connections pilote dans le backend une machine à états de connexion reposant exclusivement sur des données (avec un délai d’expiration fixe de 300 secondes pour l’opération — délibérément non configurable), et Desktop, TUI et CLI l’affichent tous sous la même forme de carte de configuration. Cette carte affiche un champ pour chaque identifiant manquant (nom, invite, caractère obligatoire) et désactive son bouton d’action jusqu’à ce que tous les champs obligatoires contiennent du texte ; le backend impose la même séparation réservée aux secrets sur chaque frontend.⁵¹

Avis d’abandon

• La variable d’environnement HERMES_ENABLE_NOUS_MANAGED_TOOLS est supprimée dans la v0.10.0. Les outils gérés sont désormais activés au moyen du champ de configuration use_gateway propre à chaque outil, sous réserve de l’état de votre abonnement Portal.⁶¹

Mise au point : ce que cette version n’est pas

Le CLI Hermes Agent n’est pas réservé aux abonnés. Le projet reste sous licence MIT et toutes les fonctionnalités principales (CLI, skills, mémoire, gateway de messagerie, cron, MCP, tableau de bord local et BYOK pour chaque fournisseur) fonctionnent de bout en bout sans aucun paiement. La v0.10.0 ajoute une option pratique pour les utilisateurs qui paient déjà un abonnement à Nous Portal ; elle ne retire rien à l’offre gratuite.

Gateway de messagerie

Hermes peut s’exécuter comme un processus gateway de longue durée qui se connecte à 28 plateformes de messagerie depuis un seul processus gateway : Telegram, Discord, Slack, WhatsApp, Signal, SMS, e-mail, Home Assistant, Mattermost, Matrix, DingTalk, Feishu/Lark, WeCom, Weixin (WeChat), BlueBubbles (iMessage), QQBot, Microsoft Teams, Tencent Yuanbao, Google Chat, LINE, SimpleX Chat, Photon (iMessage), WhatsApp Cloud API, WeCom Callback, Raft, IRC, ntfy, Buzz et un adaptateur Webhook générique.^360171819 Ce nombre de 28 provient du tableau Platform Comparison de la documentation au tag v2026.8.31 ; sous celui-ci, gateway/config.py définit 24 membres intégrés de l’énumération Platform (dont des entrées qui ne sont pas des services de chat, telles que local, api_server, webhook, msgraph_webhook et relay) et associe à la demande tout autre nom à l’un des 22 dossiers d’adaptateurs fournis sous plugins/platforms/. Un simple décompte des valeurs de l’énumération ou des dossiers ne correspondra donc pas au chiffre indiqué dans la documentation.²⁵ La v0.9.0 a ajouté iMessage via BlueBubbles (enregistrement automatique des webhooks, assistant de configuration et résistance aux plantages), ainsi qu’une prise en charge native de WeChat via iLink Bot API, avec un mode de rappel WeCom destiné aux applications d’entreprise.¹⁶ La v0.11.0 a ajouté QQBot.⁶⁰ La v0.12.0 a ajouté Microsoft Teams et Tencent Yuanbao.¹⁷ La v0.13.0 a ajouté Google Chat en tant que 20e plateforme, en s’appuyant sur la même architecture d’adaptateurs modulaires ; IRC et Microsoft Teams ont également migré vers ce nouveau modèle d’adaptateurs, avec les hooks de plugin génériques env_enablement_fn / cron_deliver_env_var.¹⁸ La v0.14.0 ajoute LINE et SimpleX Chat et complète l’ensemble de la pile Microsoft Teams, de bout en bout, avec l’authentification Graph, l’écouteur de webhooks, le pipeline d’exécution et l’envoi sortant.¹⁹ La v0.17.0 (19 juin 2026) ajoute iMessage sans relay via Photon Spectrum (OAuth par code d’appareil avec hermes photon login — aucun relay Mac/BlueBubbles requis), l’adaptateur officiel WhatsApp Business Cloud API (qui remplace l’obligation d’utiliser un processus bridge), les groupes SimpleX et les pièces jointes natives, ainsi que Raft comme plugin de plateforme intégré.²¹ Deux autres figurent dans le tableau de la documentation sans avoir été mis en avant dans les notes de version : ntfy est un canal push HTTP pub-sub léger (abonnez-vous à un sujet depuis l’application mobile ntfy, envoyez un message au sujet pour parler à l’agent et recevez sa réponse sur votre téléphone ; fonctionne avec le serveur public ntfy.sh ou une instance auto-hébergée, sans SDK ni daemon requis), tandis que Buzz connecte Hermes à une communauté Buzz, la plateforme open source de Block destinée à la collaboration entre humains et agents sur le protocole Nostr. Pour les messages sortants, il exécute le CLI buzz dans un shell et, pour les messages entrants, utilise un abonnement Nostr WebSocket natif. Tous deux sont configurés avec hermes gateway setup.²⁵

Configuration

hermes gateway setup                # Interactive platform configuration
hermes gateway install              # Install as user service (systemd/launchd)
hermes gateway start                # Start the installed service
hermes gateway stop
hermes gateway restart
hermes gateway status
hermes gateway run                  # Run in foreground (debugging)

La configuration interactive vous guide pour connecter chaque plateforme : tokens API, identifiants de bots, correspondances de canaux et listes d’autorisation.⁶

Circulation des messages

D’après la documentation d’architecture en amont :³

Platform event → Adapter.on_message() → MessageEvent
  → GatewayRunner._handle_message()
    → authorize user
    → resolve session key
    → create AIAgent with session history
    → AIAgent.run_conversation()
    → deliver response back through adapter

Toutes les plateformes de messagerie passent par la même boucle de conversation AIAgent que le CLI. C’est pourquoi les commandes slash fonctionnent de manière identique aux deux endroits et qu’une tâche cron planifiée dans Telegram peut envoyer son résultat vers Discord : la plateforme ne fait de différence qu’en périphérie.³

La v0.19.0 ajoute le routage des messages par profile et une livraison durable. Un gateway multiplexé unique partageant un seul token de bot peut acheminer des guildes, canaux ou fils de discussion précis vers différents profiles — chacun disposant d’une configuration, de skills, d’une mémoire et de secrets entièrement isolés — avec une substitution GATEWAY_MULTIPLEX_PROFILES. Une vague de renforcement garantit par ailleurs qu’un profile mal configuré ne puisse plus entraîner l’arrêt de tout le gateway. En interne, l’index de routage a été déplacé dans state.db (sessions.json n’est désormais plus qu’un miroir hérité facultatif), et les réponses finales sont consignées dans un registre durable d’obligations de livraison autour de l’envoi par la plateforme : si le gateway plante au moment d’envoyer une réponse terminée, celle-ci est renvoyée au démarrage suivant au lieu d’être silencieusement perdue.⁵⁶ L’isolation entre les profiles routés a été renforcée dans la v0.21.2, qui a corrigé un ensemble de fuites entre profiles précisément dans cette configuration multiplexée : listes d’autorisation héritées, identifiants envoyés à l’hôte du profile par défaut, secrets du coffre du profile par défaut transmis aux serveurs stdio MCP, pièces jointes MEDIA: provenant d’un autre profile et bearer Nous d’un profile voisin persistant dans les mémos propres au processus (#107609-#107630).⁴⁸

La v0.21.1 rend les limites des conversations exclusivement explicites. La documentation du cycle de vie des sessions au tag v2026.9.7 définit ce contrat en quatre phrases : « L’inactivité et le temps écoulé ne déclenchent jamais la rotation d’une conversation. /new et /reset créent une limite explicite ; la compression du contexte continue de gérer les historiques longs. L’ancienne configuration des délais est ignorée. Le type de données SessionResetPolicy existant ne constitue qu’une donnée de compatibilité inactive, et non une politique d’exécution. » Une suspension explicite crée toujours une limite au prochain tour entrant, la récupération respecte les limites finalisées au lieu de les rouvrir et l’éviction limitée aux ressources permet de reprendre les conversations. Si une session de votre gateway semble « ne jamais expirer », c’est désormais le comportement prévu ; déclenchez vous-même sa rotation avec /new.⁴³

Depuis la période de la v0.21.4, une deuxième instance de hermes gateway run se rattache au processus existant ou refuse de démarrer au lieu de créer une double liaison. La règle autorise une instance de hermes serve et une instance de hermes gateway run par hôte et par utilisateur du système d’exploitation, chacune multiplexant tous les profiles. Si vous démarrez un gateway pour un profile déjà pris en charge par le multiplexeur en cours d’exécution, la commande s’y rattache simplement et se termine avec le code 0. S’il ne prend pas encore ce profile en charge, Hermes lui demande d’analyser de nouveau profiles/, puis s’y rattache lorsqu’il le fait. S’il est impossible de lui faire prendre ce profile en charge, la commande refuse de poursuivre au lieu de démarrer silencieusement un deuxième gateway. --replace cible désormais ce processus hôte, quel que soit le profile qui l’a lancé, tandis que --force évite entièrement la question lorsque le propriétaire est bloqué. Les gateways autonomes peuvent toujours coexister : si le gateway en cours d’exécution appartient à un autre profile et fonctionne en mode autonome (sans multiplexage), votre profile démarre le sien à côté, comme auparavant, jusqu’à ce que cette migration soit imposée (#109417). Si deux gateways démarrent simultanément, celui qui ne parvient pas à obtenir le verrou de l’hôte se termine avec le code 75, que tous les superviseurs générés par Hermes retentent ; l’enregistrement du gagnant existe alors, ce qui permet à la nouvelle tentative de se rattacher ou de refuser selon les règles ci-dessus. Les verrous et l’enregistrement de rendez-vous résident sous $HERMES_GATEWAY_LOCK_DIR, ou à défaut sous $XDG_STATE_HOME/hermes/gateway-locks (par défaut ~/.local/state/hermes/gateway-locks), avec une portée limitée à l’utilisateur du système d’exploitation. Un enregistrement dont le PID est mort ou a été réattribué à un autre processus est considéré comme obsolète et ignoré : un gateway ayant planté ne bloque donc pas le prochain démarrage. L’application Desktop suit la même règle et se rattache au backend hôte en cours d’exécution au lieu d’en lancer un deuxième.⁵¹

Depuis la v0.21.5, le multiplexage n’est plus facultatif. gateway.multiplex_profiles n’accepte qu’une seule valeur, true : une clé absente est considérée comme activée et inscrite dans le config.yaml du profile par défaut, tandis qu’un false explicite est remplacé sur place par true, avec un encadré affiché une seule fois au démarrage de ce gateway, puis de nouveau dans le récapitulatif de la prochaine commande hermes update. Deux contrôles remplacent l’ancienne désactivation facultative. Pour mettre un profile hors ligne sans arrêter les bots des autres utilisateurs, exécutez hermes -p <name> gateway stop : l’hôte le met en attente (avec un marqueur profiles/<name>/gateway.parked) et hermes -p <name> gateway start le réactive. Les boutons Stop/Start du dashboard et de l’application Desktop font de même. Un profile nommé qui a encore besoin de son propre gateway définit gateway.standalone: true dans son propre config.yaml ; l’hôte ne le prend jamais en charge et ses commandes stop/start agissent sur son propre processus. La documentation qualifie cette clé de « solution temporaire de compatibilité », et non de topologie prise en charge ; elle est ignorée avec un avertissement sur le profile par défaut. Une répartition entre plusieurs utilisateurs du système d’exploitation ou un HERMES_HOME situé hors du dossier profiles/ du répertoire personnel par défaut nécessite toujours --force.⁵³

Autorisation et appairage des utilisateurs

hermes pairing list                    # Show pending and approved users
hermes pairing approve <platform> <code>
hermes pairing revoke <platform> <user-id>
hermes pairing clear-pending

Les codes d’appairage empêchent des inconnus de communiquer avec votre gateway. Un utilisateur envoie un code d’appairage depuis sa plateforme de messagerie ; vous l’approuvez avec hermes pairing approve ; il est alors autorisé à partir de ce moment.⁶

unauthorized_dm_behavior détermine la réponse qu’un inconnu reçoit par message privé avant l’appairage : pair lui envoie un code d’appairage, ignore ignore silencieusement le message et decline, valeur ajoutée durant la période de la v0.21.4, envoie un refus courtois, puis ne répond plus à cet expéditeur pendant 24 heures (#88028). Le refus est dédupliqué par plateforme et par expéditeur, y compris entre alias, et son texte provient de unauthorized_dm_decline_message (une clé globale ; une valeur vide utilise la réponse intégrée : « Bonjour ! Je suis un assistant personnel et je ne peux discuter qu’avec mon propriétaire, je ne peux donc pas vous aider directement. Désolé ! »). Définissez ce comportement globalement ou pour chaque plateforme, là où l’assistant de configuration l’inscrit :

# ~/.hermes/config.yaml
unauthorized_dm_behavior: decline      # global; gateway.unauthorized_dm_behavior also works
unauthorized_dm_decline_message: ""    # empty = built-in reply
platforms:
  telegram:
    unauthorized_dm_behavior: pair     # per-platform value always wins

Lorsque rien n’est défini, la valeur par défaut effective dépend de vos listes d’autorisation. Si aucune n’est configurée, elle vaut pair ; dès qu’une liste d’autorisation est définie (GATEWAY_ALLOWED_USERS, ou la variable des utilisateurs autorisés, des utilisateurs de groupe autorisés ou des conversations de groupe autorisées d’une plateforme), elle devient ignore. En effet, la liste d’autorisation signale un gateway volontairement restreint, et envoyer des codes à des contacts inconnus génère du bruit et risque de divulguer des informations (#9337). Une valeur globale ignore ou decline remplace cette règle, mais pas une valeur globale pair, puisqu’elle est interprétée comme la valeur par défaut. Pour conserver l’appairage parallèlement à une liste d’autorisation, définissez pair pour chaque plateforme. (La valeur dm_policy propre à l’adaptateur d’une plateforme, lorsqu’elle est définie, est consultée avant la règle de la liste d’autorisation.) Le fonctionnement de l’e-mail étant organisé autour d’une boîte de réception, sa valeur par défaut est ignore, sauf si sa propre clé propre à la plateforme active une autre option ; une valeur globale ne s’y applique pas. Lorsque vous configurez une plateforme sans liste d’autorisation, hermes gateway setup propose le refus parmi les réponses possibles.⁵¹

Tâches planifiées (Cron)

Hermes dispose d’un système cron de premier ordre dans lequel les jobs sont des tâches d’agent, et non des commandes shell. Chaque job planifié s’exécute par l’intermédiaire d’un nouvel AIAgent avec le prompt configuré et, éventuellement, des skills associés, puis transmet les résultats à la plateforme de votre choix :³⁶

hermes cron list
hermes cron create --prompt "Check HN for AI news and summarize" --schedule "0 9 * * *" --deliver telegram
hermes cron edit <id>
hermes cron pause <id>
hermes cron resume <id>
hermes cron run <id>         # Trigger now on the next tick
hermes cron remove <id>
hermes cron status           # Check if scheduler is running
hermes cron tick             # Run due jobs once and exit

Vous pouvez aussi en créer un de manière conversationnelle dans une messagerie :

Every morning at 9am, check Hacker News for AI news and send me a summary on Telegram.

L’agent configurera le job cron à l’aide de ses tools. Les jobs sont conservés dans JSON et persistent après les redémarrages.³

La v0.21.0 a doté les jobs planifiés d’une mémoire et d’une capacité de jugement. Quatre mécanismes, tous vérifiés avec le tag v2026.8.31 :³⁵³⁷

• Continuité. continuity=true injecte dans chaque exécution la sortie la plus récente du job lui-même. Ainsi, un agent d’exploration ou de surveillance « se réveille en voyant ce qu’il a signalé la fois précédente, peut éliminer les doublons et reprendre là où il s’était arrêté » ; le cadrage injecté lui demande « d’éviter de répéter ce qui a déjà été signalé ». La première exécution reste inchangée et, en interne, l’option est enregistrée sous l’entrée réservée self dans context_from. Activez ou désactivez cette option avec hermes cron create ... --continuity et hermes cron edit <job_id> --continuity / --no-continuity.³⁷
• Blocs-notes persistants. Chaque job dispose d’un petit espace de travail KV pour les curseurs, les repères de progression et les listes de surveillance (16 Ko par valeur, 64 Ko par job ; ces données étant injectées dans le prompt à chaque exécution, ces limites sont intentionnelles). Vous pouvez y écrire avec hermes cron notepad <job_id> set <key> <value>, que l’agent en cours d’exécution invoque au moyen de son tool de terminal.³⁷
• Mode surveillance. Un job peut associer une source peu coûteuse monitor_script/monitor_url, exécutée en premier à chaque cycle : si la sortie est inchangée (comparaison exacte des octets), l’exécution de l’agent est entièrement ignorée — aucun appel à LLM, aucune transmission, seulement une exécution silencieuse no_change. En cas de changement, un bloc diff est injecté et l’agent s’exécute normalement. Veillez à produire une sortie stable dans les scripts de surveillance, sans quoi chaque cycle semblera comporter un changement.³⁷
• Niveau de raisonnement propre à chaque job et transmission dans Bot Chat. --reasoning-effort fixe le niveau de réflexion d’un job (none à ultra) en remplaçant les paramètres globaux et propres au modèle pour les exécutions de ce job ; avec deliver=bot-chat, la sortie arrive dans la session Bot Chat canonique d’un profile sous la forme d’un véritable message entrant, où le bot « exécute toute action nécessaire et répond dans sa conversation », au lieu qu’un humain se contente de lire un canal.³⁷

Intégration de MCP

Hermes prend en charge le Model Context Protocol à la fois comme client et comme serveur :⁶

Comme client — connectez Hermes à des serveurs MCP externes afin d’étendre l’éventail de ses tools :

hermes mcp add <name> --url https://example.com/mcp
hermes mcp add <name> --command npx --args "-y,@modelcontextprotocol/server-github"
hermes mcp list
hermes mcp test <name>
hermes mcp remove <name>
hermes mcp configure <name>   # Toggle individual tool selection
hermes mcp login <name>       # Force re-auth for an OAuth server (--flow browser|device)
hermes mcp reauth [--all]     # Re-authenticate one OAuth server, or every one

Ou configurez-les manuellement dans config.yaml :¹⁴

mcp_servers:
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"

Depuis la v0.19.0, les tools MCP sont présentés au modèle selon la convention de nommage mcp__server__tool : chaque nom de tool comprend celui de son serveur, ce qui évite désormais les conflits lorsque deux serveurs proposent le même tool. Les notifications de journal des serveurs MCP apparaissent également dans agent.log.⁵⁶

La v0.21.1 ajoute un parcours par code d’appareil à MCP OAuth : hermes mcp login <name> accepte --flow {browser,device} — browser correspond au parcours PKCE existant, tandis que device est une connexion par code d’appareil conforme à la RFC 8628, destinée aux machines sans interface graphique ou distantes — et cette option remplace la configuration oauth.flow du serveur. Cette même version impose la propriété du profile tout au long des sessions OAuth, ignore les caches de métadonnées OAuth mal formés au lieu de bloquer un serveur et relaie MCP OAuth sur ordinateur par des callbacks locaux au client. Désormais, -t/--toolsets filtre également les serveurs MCP configurés qui sont lancés : une invocation limitée à un périmètre précis évite ainsi le démarrage à froid des serveurs dont elle n’a pas besoin.⁴⁴

La v0.21.0 transforme l’interface MCP de l’application de bureau en centre de commande : les serveurs et le catalogue sont réunis sur une seule page, avec une importation par glisser-déposer « collez n’importe quel contenu », des contrôles d’intégrité en arrière-plan qui signalent l’expiration prochaine d’une authentification avant l’échec d’un appel de tool, une vue superposée des coûts et de l’utilisation de l’ensemble des serveurs indiquant les estimations de tokens du schéma et l’utilisation sur 30 jours pour chaque serveur, ainsi que des liens profonds hermes:// permettant d’installer un serveur MCP après confirmation explicite.³⁵

La période de publication de la v0.21.4 ajoute mcp.discovery_concurrency (valeur par défaut : 4 ; 0 = illimité, #117373), qui limite le nombre de serveurs MCP configurés auxquels le processus de découverte peut se connecter simultanément. Tous les serveurs sont toujours contactés — cette limite empêche seulement qu’ils le soient tous en même temps — et une valeur négative ou qui n’est pas un entier déclenche un avertissement dans le journal, puis rétablit la valeur par défaut.⁵¹

Comme serveur — rendez les conversations Hermes accessibles à d’autres agents :

hermes mcp serve
hermes mcp serve -v    # Verbose

Compression du contexte

Hermes compresse automatiquement les longues conversations afin de respecter la fenêtre de contexte de votre modèle. Le module de synthèse utilisé pour la compression effectue un appel LLM distinct ; vous pouvez l’orienter vers n’importe quel fournisseur ou endpoint.⁴ Depuis la v0.20.6, la stratégie de conservation de la fin de conversation utilise par défaut le mode lean (compression.tail_mode: lean). Avec ce tag, les paramètres du modèle, du fournisseur et de l’endpoint du module de synthèse se trouvent sous auxiliary.compression.*, et non plus sous les anciennes clés compression.summary_* ; les clés historiques sont automatiquement migrées au premier chargement (version 17 de la configuration).³⁰³¹

compression:
  enabled: true
  threshold: 0.50          # Compress at this % of context limit
  threshold_tokens: null   # Optional absolute token cap -- trigger fires at the lower of ratio vs cap
  target_ratio: 0.20       # Fraction of threshold to preserve as recent tail (legacy tail mode)
  tail_mode: lean          # Tail retention: "lean" (default) or "legacy"
  protect_last_n: 20       # Min recent messages to keep uncompressed
  protect_first_n: 3       # Non-system head messages pinned across compactions

auxiliary:
  compression:
    model: ""              # Empty = main chat model; e.g. "google/gemini-3-flash-preview"
    provider: "auto"       # "auto", "openrouter", "nous", "codex", "main", etc.
    base_url: null         # Custom OpenAI-compatible endpoint (overrides provider)

Ce que détermine tail_mode. legacy conserve textuellement une fin de conversation dont la taille correspond à target_ratio ; avec une grande fenêtre ou un seuil relevé, cela accapare 100 000 à 240 000 tokens à chaque compression. lean conserve textuellement une fin de conversation limitée à 2,5 % de la fenêtre de contexte (plancher de 10 000, plafond de 25 000) et assure plutôt la continuité dans le résumé : un journal de session détaillé de la partie compressée, qui préserve les identifiants (un appel auxiliaire au module de synthèse par tentative), un index des éléments d’ancrage extrait mécaniquement (numéros de PR, SHA, chemins, messages d’erreur — par expression régulière, sans aucune reformulation), chaque véritable message de l’utilisateur cité textuellement, ainsi qu’un pointeur de récupération session_search permettant à l’agent d’accéder de nouveau à tout contenu évincé par la synthèse. Résultat mesuré dans la documentation sur de véritables sessions de 500 000 tokens : environ 49 000 tokens conservés au lieu d’environ 162 000. Les anciens résultats de tools situés dans la fin de conversation conservée par lean sont réduits à des résumés d’une ligne contenant un pointeur de récupération, et toute valeur tail_mode inconnue revient par défaut à lean.³¹

Options de fournisseur :⁴³¹

Le modèle de synthèse doit prendre en charge une longueur de contexte au moins égale à celle de votre modèle principal, car il reçoit l’intégralité de la partie centrale de la conversation en un seul appel. Si sa fenêtre est plus petite, l’appel échoue et les tours de conversation intermédiaires sont supprimés sans résumé.⁴³¹

Avertissements de pression sur le budget

Lorsque l’agent traite une tâche complexe nécessitant de nombreux appels de tools, il peut épuiser son budget d’itérations (500 tours par défaut depuis la v0.20.0, contre 90 auparavant) sans s’en rendre compte. La pression sur le budget avertit automatiquement le modèle :⁴

Délais d’expiration des flux

La connexion de streaming LLM comporte deux niveaux de délai d’expiration, qui s’ajustent automatiquement pour les fournisseurs locaux (localhost, adresses IP du réseau local) :⁴

Le délai de lecture du socket est porté à 30 minutes pour les endpoints locaux, car les LLM locaux peuvent consacrer plusieurs minutes au préremplissage des contextes volumineux avant de produire le premier token.⁴

Tableau de bord web local (v0.9.0+)

Un tableau de bord accessible depuis un navigateur vous permet de gérer Hermes Agent en local. Configurez les paramètres, surveillez les sessions, parcourez les skills et gérez votre gateway sans modifier les fichiers de configuration ni utiliser le terminal.¹⁶ Lancez-le avec hermes dashboard. Il s’agit du parcours de prise en main le plus simple pour les nouveaux utilisateurs qui préfèrent une interface graphique.

Surveillance des processus en arrière-plan (v0.9.0+)

watch_patterns vous permet de définir des motifs à surveiller dans la sortie des processus en arrière-plan et d’être averti en temps réel lorsqu’ils correspondent.¹⁶ Surveillez les erreurs, attendez des événements précis (« listening on port ») ou suivez les journaux de compilation — le tout sans interrogation périodique. Associé à notify_on_complete, introduit dans la v0.8.0 (qui signale la fin des tâches en arrière-plan), Hermes dispose désormais d’une couche complète d’observabilité des processus en arrière-plan.¹⁵

Context engine modulaire (v0.9.0+)

La gestion du contexte est désormais un emplacement modulaire accessible via hermes plugins. Remplacez le context engine par une implémentation personnalisée qui contrôle ce que l’agent voit à chaque tour — filtrage, synthèse ou injection de contexte propre à un domaine.¹⁶ Cette architecture dissocie la stratégie de contexte de la boucle principale de l’agent, ce qui permet de la personnaliser pour chaque projet ou domaine.

Sauvegarde et restauration (v0.9.0+)

hermes backup crée une archive complète de votre configuration, de vos sessions, de vos skills et de votre mémoire. hermes import effectue une restauration à partir d’une archive de sauvegarde.¹⁶ Utilisez ces commandes pour migrer d’une machine à une autre, créer des instantanés avant des modifications majeures ou partager une configuration fiable avec vos collègues.

Prise en charge de Termux / Android (v0.9.0+)

Hermes s’exécute nativement sur Android via Termux. Les chemins d’installation adaptés, les optimisations de la TUI pour les écrans mobiles, la prise en charge des moteurs vocaux et la commande /image fonctionnent directement sur l’appareil.¹⁶

Renforcement de la sécurité (v0.13.0+)

La v0.13.0 a corrigé 8 problèmes de sécurité P0 et modifié un paramètre par défaut en faveur de l’utilisateur.¹⁸ La v0.14.0 poursuit sur cette lancée en corrigeant 12 autres problèmes P0 et 50 problèmes P1, notamment par le renforcement de la protection contre les attaques par force brute sur sudo et de sudo-stdin, la correction des contournements liés aux commandes dangereuses, l’assainissement des erreurs d’outils avant leur réinjection dans le modèle, l’authentification API des plugins du tableau de bord, la couverture SSRF du hub de skills et l’analyse des avis de sécurité relatifs à la chaîne d’approvisionnement pendant l’installation.¹⁹

Si vous maintenez un déploiement de Hermes, considérez les v0.13.0 et v0.14.0 comme des mises à niveau de sécurité, et non comme de simples livraisons de fonctionnalités. La v0.13.0 corrige le contournement entre guildes Discord et deux fenêtres TOCTOU ; la v0.14.0 ajoute une nouvelle série de renforcements concernant la gestion de sudo, la réinjection des erreurs d’outils, les APIs de plugins, les SSRF du hub de skills et les avis de sécurité relatifs aux dépendances.

La v0.21.0 ajoute une quatrième vague. Les écritures dans les fichiers protégés d’instructions de l’agent – AGENTS.md, CLAUDE.md, SOUL.md, .cursorrules, les skills et les espaces de stockage de la mémoire – nécessitent désormais toujours une approbation, de sorte qu’un agent victime d’une injection de prompt ne puisse pas réécrire discrètement ses propres directives permanentes. Ce verrou est activé par défaut (security.protected_instruction_files: true, avec une liste d’extensions de noms de base utilisant fnmatch dans protected_instruction_extra_patterns), et le code source désigne précisément le vecteur neutralisé : « an injected instruction that edits AGENTS.md / CLAUDE.md / SOUL.md », en précisant que les fichiers d’instructions sont chargés depuis les arborescences du répertoire de travail courant, si bien que « an AGENTS.md anywhere the agent might later run from is a live target. »³⁵³⁹ La même version comble les failles susceptibles d’entraîner la divulgation de secrets dans les erreurs du terminal, la lecture des fichiers .env, les checkpoints et les journaux ACP ; apprend au système d’approbation à reconnaître les commandes et chemins destructeurs sous Windows ; permet aux autorisations macOS de survivre aux mises à jour grâce à une identité de signature TCC stable (configuration ponctuelle : hermes desktop --setup-tcc-identity, uniquement sous macOS, nécessite openssl/security/codesign) ; supprime l’entrée Blender MCP du catalogue ainsi que son skill après la compromission d’un composant en amont ; et ajoute une analyse de sécurité de niveau Tier-1 lors de l’installation des plugins.³⁵³⁹

Architecture pour les praticiens

Cette section s’adresse à celles et ceux qui souhaitent comprendre le fonctionnement interne afin de pouvoir le déboguer, l’étendre ou analyser ses performances. Elle synthétise la documentation d’architecture du projet en amont.³

Points d’entrée → AIAgent

Tous les points d’entrée de Hermes finissent par appeler AIAgent.run_conversation() :

┌──────────────────────────────────────────────────────────────────┐
│                        Entry Points                              │
│                                                                  │
│  CLI (cli.py)    Gateway (gateway/run.py)    ACP (acp_adapter/)  │
│  Batch Runner    API Server                  Python Library     │
└──────────┬──────────────┬───────────────────────┬────────────────┘
           │              │                       │
           ▼              ▼                       ▼
┌──────────────────────────────────────────────────────────────────┐
│                     AIAgent (run_agent.py)                       │
│                                                                  │
│  ┌─────────────┐  ┌──────────────┐  ┌──────────────┐             │
│  │ Prompt      │  │ Provider     │  │ Tool         │             │
│  │ Builder     │  │ Resolution   │  │ Dispatch     │             │
│  └──────┬──────┘  └──────┬───────┘  └──────┬───────┘             │
│         │                │                 │                    │
│  ┌──────┴───────┐ ┌──────┴───────┐  ┌──────┴───────┐             │
│  │ Compression  │ │ 3 API Modes  │  │ Tool Registry│             │
│  │ & Caching    │ │ chat_compl   │  │ 47 tools     │             │
│  │              │ │ codex_resp   │  │ 20 toolsets  │             │
│  │              │ │ anthropic    │  │              │             │
│  └──────────────┘ └──────────────┘  └──────────────┘             │
└──────────────────────────────────────────────────────────────────┘

Schéma adapté de la documentation d’architecture du projet en amont.³

« 47 tools / 20 toolsets » contre « 28 tools » dans votre bannière. Le nombre « 47 tools » correspond au registre total des outils du dépôt en amont, c’est-à-dire tous les outils dont le code source est fourni avec Hermes, tous toolsets confondus. Votre CLI en cours d’exécution affichera un nombre inférieur dans sa bannière de démarrage (l’installation utilisée pour vérifier ce guide indique 28 tools / 89 skills). Ce n’est pas un bug. De nombreux toolsets sont facultatifs et doivent être explicitement activés dans config.yaml, sous toolsets: : adaptateurs de plateformes de messagerie, automatisation du navigateur, outils de scraping plus lourds, etc. Le total du registre indique « ce qui est disponible » ; le nombre affiché dans la bannière, « ce qui est activé dans votre profile actuel ». Vérifiez les toolsets actifs avec hermes tools --list, puis activez ou désactivez chaque toolset à l’aide du bloc toolsets: dans ~/.hermes/config.yaml (ou avec /tools list / /tools enable <name> / /tools disable <name> au sein d’une session en cours d’exécution — la suppression d’un outil réinitialise la session afin que l’agent reconstruise son manifeste d’outils).

Les trois modes API

Hermes abstrait les différences entre fournisseurs au moyen de trois modes API, sélectionnés automatiquement lors de l’exécution :³

Le résolveur runtime_provider.py associe les tuples (provider, model) à (api_mode, api_key, base_url) pour plus de 18 fournisseurs, tout en gérant les flux OAuth, les pools d’identifiants et la résolution des alias.³

Flux de données au sein d’une session CLI

User input → HermesCLI.process_input()
  → AIAgent.run_conversation()
    → agent.prompt_builder.build_system_prompt()
    → runtime_provider.resolve_runtime_provider()
    → API call (chat_completions / codex_responses / anthropic_messages)
    → tool_calls? → model_tools.handle_function_call() → loop
    → final response → display → save to SessionDB

Extrait de la page d’architecture du projet en amont.³

Ordre d’assemblage du prompt

La pile du prompt comprend :¹³

1. SOUL.md (identité de l’agent — ou solution de repli intégrée si le fichier est indisponible)
2. Consignes de comportement tenant compte des outils
3. Mémoire et contexte utilisateur (MEMORY.md, USER.md)
4. Consignes relatives aux skills
5. Fichiers de contexte (AGENTS.md, .cursorrules)
6. Horodatage
7. Indications de mise en forme propres à la plateforme
8. Surcouches facultatives du prompt système, telles que /personality

SOUL.md constitue le socle : tout le reste vient s’y superposer.¹³

Stockage des sessions

Le stockage des sessions repose sur SQLite et la recherche en texte intégral FTS5. Les sessions bénéficient d’un suivi de filiation (relations parent-enfant après les compressions), d’une isolation par plateforme et d’écritures atomiques avec gestion des accès concurrents.³

Si le stockage vous pose problème avec une installation v0.21.x, utilisez la version v0.21.2 ou ultérieure : elle a corrigé la série de fragilités de state.db apparues avec la v0.21.0 (les seconds processus d’écriture annulaient mutuellement leurs verrous, des bases de données saines étaient signalées comme corrompues et une seule ligne défectueuse faisait échouer sessions list) et déplacé la coordination des salons hébergés hors du stockage racine, vers un fichier shared-state.db dédié, afin que les gateways des profiles n’ouvrent jamais le stockage principal des sessions en écriture. hermes doctor distingue désormais les dommages structurels de ceux touchant l’index FTS ; les dommages FTS dégradent la recherche au lieu de faire échouer le tour, tandis que hermes sessions recover --inspect-only (hors ligne, non destructif et lié au profile) vérifie la lisibilité des tables canoniques sans créer de base de données de sortie — la sous-commande existait déjà avant cette période, mais n’avait pas encore été documentée ici. Consultez Les nouveautés de la v0.21.2.⁴⁸ Pour un stockage bloqué dans le mauvais mode de journalisation SQLite, la période de la v0.21.4 a ajouté le convertisseur hors ligne hermes sessions set-journal-mode delete|wal (consultez la ligne hermes sessions dans les Commandes de premier niveau).⁵¹

Système de plugins

Trois sources de découverte : ~/.hermes/plugins/ (utilisateur), .hermes/plugins/ (projet) et les points d’entrée pip. Les plugins enregistrent des outils, des hooks et des commandes CLI par l’intermédiaire d’un API de contexte. Les fournisseurs de mémoire constituent un type de plugin spécialisé sous plugins/memory/.³ Depuis la v0.21.2, un catalogue de plugins sélectionnés et épinglés par SHA permet également de parcourir les plugins et de les installer par leur nom, tandis que hermes plugins pack prend en charge les « ensembles de plugins déclaratifs et partageables » : un fichier hermes-pack.yaml unique épingle un ensemble de plugins à des SHA de commit précis, l’installation d’un pack se décompose en installations épinglées ordinaires et le consentement aux capacités reste propre à chaque plugin.⁴⁸

La période de la v0.21.4 a transformé ce catalogue, auparavant simple surface CLI, en un artefact fourni avec le produit. Le dossier plugin-catalog/ du dépôt est passé de 9 entrées dans v2026.9.14 à 228 dans v2026.9.21 — un YAML vérifié par plugin (nom, dépôt, responsable, niveau, catégorie, capacités), épinglé à un SHA de commit exact de 40 caractères, la présence dans le dossier valant admission — et publié sous la forme de plugin-catalog.json pour le CLI (récupéré en direct et mis en cache sous ~/.hermes/cache/). Le site de documentation génère désormais, à partir de ces mêmes données, une page par plugin (/docs/plugins/<name>) et par auteur (/docs/plugins/by/<slug>) ; chaque page affiche le README du plugin récupéré depuis le commit épinglé, jamais depuis la pointe d’une branche, en passant par une liste d’autorisation appliquée lors de la compilation qui supprime le HTML brut, avec un tri par ajout ou mise à jour horodaté d’après les dates des auteurs des commits. Les dix plugins communautaires cités dans la version v0.21.4 figurent tous dans le catalogue à ce tag, sous leurs véritables slugs : hermes-tailscale, hermes-ssh, shodan, hermes-terminal, hermes-rss (ainsi qu’un rss-reader distinct), hermes-resetwatch, done-bell, kiwi, cognee et web-octen. Sur l’application de bureau, le hub Plugins permet désormais de désinstaller un plugin après confirmation : les plugins du catalogue passent par plugins.manage remove, tandis que les plugins de bureau autonomes passent par le chargeur Electron.⁵¹

hermes plugins                       # Interactive enable/disable UI
hermes plugins browse                # List every curated plugin catalog entry (v0.21.2+)
hermes plugins search <query>        # Search the curated plugin catalog (v0.21.2+)
hermes plugins install <name|repo>   # Install from the curated catalog, a Git URL, or owner/repo
hermes plugins enable <name>
hermes plugins disable <name>
hermes plugins list
hermes plugins pack install <src>    # Shareable SHA-pinned plugin sets; also: pack export, pack show (v0.21.2+)

Fenêtre de compatibilité (v0.21.1), désormais expirée : les plugins externes devaient abandonner les chemins d’importation antérieurs à la décomposition avant le 14 septembre 2026. La décomposition de septembre 2026 (PR #102117) a déplacé les composants internes couramment importés par les plugins, et une couche temporaire COMPAT_MANIFEST.md réexportait depuis leurs anciens modules 1 148 noms publics déplacés, avec un avertissement unique par nom et par processus (HermesPluginCompatWarning). La suppression a pris effet comme prévu le 14 septembre 2026, au moyen d’une condition de date dans le code distribué (COMPAT_REMOVAL_DATE dans hermes_cli/plugin_compat.py ; aucun rétablissement du code n’a été nécessaire) : depuis cette date, tout plugin concerné est désactivé — il n’est pas chargé, une alerte rouge apparaît dans la bannière CLI, hermes doctor et hermes update, une fenêtre modale s’affiche une seule fois dans l’application de bureau et le motif figure dans hermes plugins list. Pour les auteurs : hermes plugins compat <path> continue d’afficher chaque occurrence sous la forme file:line, avec ancien chemin -> nouveau chemin, et renvoie le code 1 tant qu’il en reste (ajoutez --json pour obtenir une sortie lisible par une machine). Les utilisateurs contraints de conserver un plugin qui n’est plus maintenu peuvent toujours définir plugins.allow_deprecated_imports: true dans config.yaml — la valeur doit être un booléen YAML littéral, et non une chaîne entre guillemets — et cette option fonctionne encore, car le rétablissement qui supprime les anciens chemins n’a pas été intégré : le manifeste et les shims sont présents dans v2026.9.14, v2026.9.21, v2026.9.24 ainsi que dans main au 24 septembre (durant la période de la v0.21.4, le module de compatibilité n’a été modifié que pour mettre en cache les analyses de plugins et normaliser les chemins Windows ; durant celle de la v0.21.5, hermes_cli/plugin_compat.py est resté inchangé et seules les entrées du manifeste correspondant au module Hindsight supprimé ont été retirées). Cette échappatoire cessera de fonctionner dès l’intégration de ce rétablissement, puisque les anciens chemins disparaîtront alors. Seuls les noms publics de premier niveau étaient couverts ; les noms privés et les points de raccordement utilisés par les monkeypatchs dans les tests n’ont jamais fait partie de l’interface publique et ne sont pas restaurés.⁴²⁵³

Principes de conception

D’après la page d’architecture du projet en amont :³

Migration depuis OpenClaw

Hermes Agent succède à OpenClaw. Si vous effectuez une migration depuis une installation OpenClaw existante :⁶⁵

hermes claw migrate --dry-run                    # Preview what would be migrated
hermes claw migrate --preset full                # Full migration including API keys
hermes claw migrate --preset user-data --overwrite   # User data only, no secrets
hermes claw migrate --source /custom/path        # Non-default OpenClaw location

hermes claw migrate lit par défaut les données depuis ~/.openclaw (et détecte aussi automatiquement les anciens dossiers ~/.clawdbot et ~/.moldbot) et les écrit dans ~/.hermes.⁶

Importés directement (plus de 30 catégories) : SOUL.md, MEMORY.md, USER.md, AGENTS.md, les skills provenant de 4 dossiers sources, le modèle par défaut, les fournisseurs personnalisés, les serveurs MCP, les jetons et listes d’autorisation des plateformes de messagerie (Telegram, Discord, Slack, WhatsApp, Signal, Matrix, Mattermost), les paramètres par défaut de l’agent (effort de raisonnement, compression, délai humain, fuseau horaire, sandbox), les politiques de réinitialisation des sessions (désormais inactives : depuis la v0.21.1, les minuteurs ne renouvellent jamais une conversation⁴³), les règles d’approbation, la configuration TTS, les paramètres du navigateur, les paramètres des outils, le délai d’expiration des exécutions, la liste d’autorisation des commandes, la configuration du gateway et les clés API issues de 3 sources.⁶

Archivés pour examen manuel : les tâches cron, les plugins, les hooks/webhooks, le backend de mémoire (QMD), la configuration du registre des skills, l’interface utilisateur/l’identité, la journalisation, la configuration multi-agent, les associations de canaux, IDENTITY.md, TOOLS.md, HEARTBEAT.md, BOOTSTRAP.md.⁶

La résolution des clés API vérifie trois sources par ordre de priorité : valeurs de configuration → ~/.openclaw/.env → auth-profiles.json.⁶

Résolution des problèmes

« No inference provider configured. Run ‘hermes model’ to choose a provider and model »

C’est la première erreur rencontrée après toute nouvelle installation : Hermes n’a pas encore déterminé de fournisseur. Le message signifie exactement ce qu’il indique — aucun des trois parcours d’authentification n’a fourni de fournisseur utilisable. Exécutez :

hermes model

Le sélecteur interactif vous guide parmi tous les fournisseurs pris en charge, notamment les parcours par code d’appareil OAuth (Nous Portal, GitHub Copilot, Anthropic, OpenAI Codex) et les endpoints personnalisés pour les serveurs auto-hébergés. Si vous pensiez qu’un fournisseur était déjà configuré, hermes doctor indique les identifiants auxquels Hermes a réellement accès ; les causes habituelles sont une clé API définie au mauvais endroit (elle doit se trouver dans .env ou être définie avec hermes config set, et non dans votre profile de shell), un identifiant OAuth expiré dans ~/.hermes/auth.json, ou un endpoint personnalisé dans config.yaml ayant perdu son base_url. Les parcours d’authentification sont présentés en détail dans Authentification et fournisseurs.²⁷

« Clé API non définie »

Exécutez hermes model pour configurer votre fournisseur de manière interactive, ou hermes config set OPENROUTER_API_KEY your_key. La commande hermes doctor vous indiquera précisément quelles clés sont manquantes.⁷

« Context limit: 2048 tokens » au démarrage (modèles locaux)

Hermes détecte automatiquement la longueur du contexte à partir de l’endpoint /v1/models de votre serveur, mais de nombreux serveurs locaux signalent des valeurs par défaut faibles. Définissez-la explicitement dans config.yaml :²

model:
  default: your-model
  provider: custom
  base_url: http://localhost:11434/v1
  context_length: 32768

Les appels d’outils apparaissent sous forme de texte au lieu d’être exécutés

L’appel d’outils n’est pas activé sur votre serveur, ou le modèle ne le prend pas en charge dans l’implémentation du serveur.²

Les réponses sont interrompues au milieu d’une phrase

Deux causes sont possibles :²

1. Plafond de sortie faible (max_tokens) sur le serveur — SGLang limite par défaut chaque réponse à 128 tokens. Définissez --default-max-tokens sur le serveur ou configurez model.max_tokens dans config.yaml.
2. Épuisement du contexte — Le modèle a rempli sa fenêtre de contexte. Augmentez model.context_length ou activez la compression du contexte dans Hermes.

« Connection refused » depuis WSL2 vers un serveur de modèles hébergé sous Windows

WSL2 utilise un adaptateur réseau virtuel avec son propre sous-réseau — dans WSL2, localhost désigne la machine virtuelle Linux, et non l’hôte Windows. Deux possibilités :²

Réseau en miroir (Windows 11 22H2 ou version ultérieure) : modifiez %USERPROFILE%\.wslconfig :

[wsl2]
networkingMode=mirrored

Exécutez ensuite wsl --shutdown, puis redémarrez. localhost fonctionne désormais dans les deux sens.

Solution de repli avec l’adresse IP de l’hôte (anciennes versions de Windows) : récupérez l’adresse IP de l’hôte Windows depuis WSL2 et utilisez-la à la place de localhost :

ip route show | grep -i default | awk '{ print $3 }'
# Use that IP as the base_url host

Le serveur de modèles doit également écouter sur 0.0.0.0, et non sur 127.0.0.1 — définissez OLLAMA_HOST=0.0.0.0 pour Ollama, ajoutez --host 0.0.0.0 pour llama-server/SGLang ou activez « Serve on Network » dans LM Studio.²

Le budget d’itérations ignore agent.max_turns

Si la ligne d’activité affiche N/90 (ou une autre limite obsolète) alors que config.yaml indique agent.max_turns: 500, la cause probable est une ligne HERMES_MAX_ITERATIONS obsolète dans ~/.hermes/.env : auparavant, l’assistant de configuration enregistrait le budget dans les deux emplacements et, si le bridge de démarrage s’interrompt en raison d’une erreur antérieure d’analyse de la configuration, la valeur fantôme de .env l’emporte silencieusement. Depuis la v0.21.1, hermes doctor détecte cette paire conflictuelle et hermes doctor --fix supprime la ligne de .env, laissant config.yaml faire autorité.⁴¹

Où tout se trouve-t-il ?

hermes status et hermes dump sont vos alliés. hermes logs list affiche tous les fichiers journaux avec leur taille. hermes config path affiche l’emplacement du fichier de configuration. hermes config env-path affiche l’emplacement de .env.⁶

FAQ

Quelle est la différence entre Hermes Agent et Claude Code ?

Claude Code est le CLI officiel de Anthropic, limité aux modèles Anthropic. Hermes Agent est un framework d’agent open source développé par Nous Research, compatible avec tous les fournisseurs prenant en charge OpenAI : Nous Portal, OpenRouter, Anthropic, GitHub Copilot, z.ai, Kimi, MiniMax, DeepSeek, Hugging Face, Google ou votre propre endpoint auto-hébergé.¹² Hermes intègre également un gateway de messagerie pour Telegram/Discord/Slack/WhatsApp/Signal, dont Claude Code ne dispose pas.

Puis-je utiliser Hermes avec une clé API Anthropic ?

Oui. Trois méthodes sont possibles :²

1. Définissez ANTHROPIC_API_KEY dans ~/.hermes/.env, puis exécutez hermes chat --provider anthropic --model claude-sonnet-4-6
2. Exécutez hermes model et sélectionnez Anthropic : Hermes utilisera le stockage d’identifiants de Claude Code lorsqu’il est disponible
3. Définissez manuellement un ANTHROPIC_TOKEN (setup-token ou token OAuth) comme solution de secours

L’option 2 est préférable si vous utilisez déjà Claude Code sur la même machine : elle permet aux identifiants Claude renouvelables de rester renouvelables.

Comment changer de fournisseur sans perdre ma conversation ?

Utilisez /model provider:model au sein d’une session. L’historique de la conversation, la mémoire et les skills sont intégralement conservés :⁹

/model zai:glm-5
/model openrouter:anthropic/claude-sonnet-4
/model custom:local:qwen-2.5

J’ai configuré Anthropic, mais la vision, le Web et la compression ne fonctionnent pas

Avec les versions actuelles, l’ancien problème ne peut pratiquement plus se produire. Par défaut (auxiliary.*.provider: "auto"), chaque tâche auxiliaire — vision, classification des approbations, compression, titres de session — s’exécute avec votre modèle de chat principal. Une configuration reposant uniquement sur Anthropic les prend donc en charge avec le OAuth dont elle dispose déjà. L’ancien comportement par défaut (Gemini Flash via OpenRouter → Nous → détection automatique de Codex, avec une dégradation silencieuse lorsqu’aucun n’était configuré) a disparu : « auto utilise désormais le modèle principal pour tout le monde, tandis que les remplacements propres à chaque tâche dans config.yaml restent prioritaires. »³⁴

Si une tâche auxiliaire échoue encore, recherchez un remplacement explicite propre à cette tâche qui pointe vers un fournisseur que vous n’avez jamais configuré (auxiliary.<task>.provider / .model dans config.yaml), ou d’anciennes clés obsolètes : depuis le tag v2026.8.31, le modèle de synthèse utilisé pour la compression se configure comme tous les autres emplacements auxiliaires — auxiliary.compression.provider — et les anciennes clés compression.summary_* y sont automatiquement migrées (version 17 de la configuration).³¹ L’extraction Web n’est désormais plus du tout une tâche LLM (« aucun LLM n’intervient »). Dans les versions actuelles, un échec de synthèse Web ne relève donc pas d’un problème de modèle auxiliaire.³⁴ Pour rattacher explicitement une tâche à votre fournisseur principal :

auxiliary:
  vision:      { provider: "main" }
  compression: { provider: "main" }

Quelle est la différence entre SOUL.md et AGENTS.md ?

SOUL.md définit l’identité de votre agent : ton, style et préférences de communication par défaut. Il se trouve dans ~/.hermes/SOUL.md et vous accompagne partout. AGENTS.md est propre à un projet : architecture, conventions, commandes et chemins. Il se trouve dans le dossier de votre projet.¹³ Si une information doit vous accompagner partout, placez-la dans SOUL.md. Si elle appartient à un projet, placez-la dans AGENTS.md.

Comment exécuter plusieurs instances de Hermes côte à côte ?

Utilisez des profiles. Chaque profile dispose de son propre HERMES_HOME, de sa propre configuration, de sa propre mémoire, de ses propres sessions et de son propre PID de gateway :⁶

hermes profile create work --clone
hermes profile use work                 # Sticky default
hermes -p work chat -q "..."            # One-off without switching
hermes profile alias work --name h-work # Wrapper script

Hermes prend-il en charge les LLMs locaux ?

Oui, grâce aux endpoints personnalisés. Hermes fonctionne avec tous les serveurs compatibles avec OpenAI : Ollama, vLLM, SGLang, llama.cpp/llama-server, LM Studio, LocalAI, Jan ou le vôtre.² Consultez Endpoints personnalisés et auto-hébergés pour connaître la configuration propre à chaque serveur.

Pourquoi ma bannière de démarrage affiche-t-elle moins d’outils que le nombre indiqué dans le guide ?

Le guide mentionne 47 outils et 20 toolsets provenant du registre d’architecture en amont : il s’agit du nombre total d’outils dont Hermes fournit le code source, tous toolsets confondus. Votre installation en cours d’exécution affiche un nombre inférieur dans la bannière (l’installation de référence utilisée pour ce guide en indique 28), car Hermes n’active au démarrage que l’ensemble de toolsets par défaut. De nombreux toolsets sont facultatifs : les adaptateurs de gateway de messagerie, l’automatisation du navigateur, les piles d’extraction Web plus lourdes et plusieurs intégrations spécialisées doivent être explicitement répertoriés sous toolsets: dans ~/.hermes/config.yaml avant d’être chargés. Total du registre = « ce qui est disponible si vous l’activez ». Total de la bannière = « ce que votre profile actuel a effectivement chargé ». Utilisez hermes tools --list pour voir quels toolsets sont actifs et lesquels sont disponibles, mais désactivés. Activez ou désactivez individuellement les toolsets pendant l’exécution avec /tools enable <name> et /tools disable <name> (la désactivation entraîne une réinitialisation de la session afin que l’agent reconstruise son manifeste d’outils avec la nouvelle structure).

Comment Hermes gère-t-il le modèle de secours lorsque mon fournisseur principal échoue ?

Configurez un bloc fallback_model dans config.yaml :²

fallback_model:
  provider: openrouter
  model: anthropic/claude-sonnet-4

Lorsque le fournisseur principal échoue (limitation du débit, erreur du serveur ou échec d’authentification), Hermes bascule vers le modèle de secours en cours de session sans perdre l’historique de la conversation. Cette opération ne se déclenche qu’une seule fois au maximum par session.

L’agent peut-il améliorer ses propres skills au fil du temps ?

Oui — c’est la dimension « auto-améliorante » de Hermes Agent. L’agent peut créer, mettre à jour et supprimer des skills à l’aide de l’outil skill_manage. Lorsqu’il met au point un workflow complexe, il enregistre la méthode sous forme de skill afin de pouvoir la réutiliser ultérieurement.¹¹ L’agent crée des skills après des tâches complexes (plus de 5 appels d’outils), lorsqu’il rencontre des erreurs et trouve la bonne méthode, lorsque vous corrigez son approche ou lorsqu’il découvre un workflow complexe.

Existe-t-il une intégration aux IDE ?

Oui — Hermes peut fonctionner comme serveur ACP (Agent Client Protocol) pour VS Code, Zed et JetBrains :⁶

pip install -e '.[acp]'
hermes acp

Journal des modifications