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

TL;DR : Hermes Agent est un agent d’IA open source auto-améliorant de Nous Research. Il fonctionne comme une CLI et comme une gateway de messagerie multiplateforme, stocke une identité durable et une mémoire persistante sur disque, agrège des skills qui s’améliorent à l’usage, et fonctionne avec tout 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é.¹²¹⁹ Depuis la v0.14.0 (16 mai 2026), Hermes ajoute SuperGrok OAuth avec le contexte grok-4.3 de 1 M, un proxy local compatible OpenAI pour les fournisseurs OAuth (hermes proxy), x_search natif, la prise en charge de l’installation via PyPI (dépréciée depuis la v0.19.0 — l’installateur en une ligne est la méthode prise en charge), des installations de dépendances à la demande, 28 plateformes de messagerie avec LINE et SimpleX Chat, /handoff, des diagnostics sémantiques LSP après les écritures, video_generate unifié, computer_use via cua-driver pour les fournisseurs autres que Anthropic, une bêta Windows native, et la résolution de 12 P0 / 50 P1.¹⁹ La partie la plus difficile pour la plupart des nouveaux utilisateurs est l’authentification des fournisseurs : Hermes prend en charge environ 20 fournisseurs de premier plan ainsi que des endpoints personnalisés, et trois chemins 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 à apprendre — tout le reste dépend du fournisseur résolu.

Hermes Agent fonctionne comme un runtime d’agent complet, et non comme un wrapper de chat. Il lit votre système de fichiers, exécute des commandes dans des backends sandboxés, explore le web, lance des sous-agents, exécute des tâches cron planifiées, communique avec Telegram/Discord/Slack/WhatsApp/Signal/e-mail depuis un unique processus gateway, et crée ses propres skills à partir de son expérience.¹ La CLI est une interface terminal construite au-dessus d’une boucle de conversation dans run_agent.py ; la gateway est un processus de longue durée qui achemine les messages des plateformes de messagerie via 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 devient un multiplicateur de force :

1. Résolution des fournisseurs : comment les flux d’authentification se mappent aux appels API
2. Hiérarchie de configuration : config.yaml + .env + auth.json + SOUL.md + AGENTS.md
3. Système d’outils + toolset : ce que l’agent peut faire, contrôlé selon la plateforme
4. Système de skills : mémoire procédurale que l’agent crée et fait évoluer
5. Gateway + cron + profiles : exécuter Hermes là où vous vivez, pas seulement là où vous êtes

Points clés

• L’authentification des fournisseurs suit trois chemins, pas un seul. Clé API dans .env, OAuth via hermes model/hermes auth, ou endpoint personnalisé dans config.yaml. Choisissez le chemin correspondant à votre fournisseur, pas celui qui vous semble familier.
• Changer de fournisseur se fait avec une seule commande. hermes model vous guide de manière interactive à travers tous les fournisseurs pris en charge, y compris les connexions OAuth, et /model provider:model effectue le changement en cours de session sans perdre l’historique.²
• Deux fichiers constituent la surface de configuration modifiable par l’utilisateur. ~/.hermes/config.yaml contient les paramètres et ~/.hermes/.env contient les secrets. auth.json, SOUL.md, MEMORY.md et skills/ sont gérés directement par Hermes — vous pouvez modifier SOUL.md à la main, mais le reste est manipulé par l’agent lui-même.⁴
• Hermes est le successeur d’OpenClaw. Si vous migrez, hermes claw migrate importe automatiquement plus de 30 catégories d’état.⁵
• La qualité de service dépend de votre modèle auxiliaire. La vision, le résumé web, la compression et la vidange de mémoire utilisent tous un LLM auxiliaire distinct. Par défaut, il s’agit de Gemini Flash via détection automatique (OpenRouter → Nous → Codex) — si aucun d’entre eux n’est configuré, ces fonctionnalités se dégradent silencieusement jusqu’à ce que vous dirigiez les emplacements auxiliaires vers votre fournisseur principal.⁴

Ce que change la v0.14

La v0.14.0 vise moins une fonctionnalité phare que la réduction des frictions d’installation tout en élargissant les environnements où Hermes peut fonctionner.¹⁹ Les principaux changements opérationnels :

• L’installation et le démarrage sont plus légers. pip install hermes-agent fonctionne depuis PyPI, les adaptateurs lourds s’installent à la demande lors de leur première utilisation, et le chemin de lancement diffère suffisamment de travail pour réduire le démarrage à froid d’environ 19 secondes. (La v0.19.0 a depuis déprécié les installations via pip — consultez Installation.)
• Les abonnements peuvent devenir des endpoints API locaux. hermes proxy transforme les fournisseurs basés sur OAuth, tels que Claude Pro, ChatGPT Pro et SuperGrok, en endpoint local compatible OpenAI pour des outils comme Codex, Aider, Cline et Continue.
• La portée de la gateway s’étend. LINE et SimpleX Chat portent le nombre de plateformes à 22, Microsoft Teams est connecté de bout en bout, le remplissage de l’historique Discord est activé par défaut, et les invites clarify de Telegram/Discord utilisent désormais des boutons natifs.
• La vérification au moment de l’écriture s’améliore. Après les modifications, Hermes peut afficher des résumés par tour des mutations de fichiers ainsi que des diagnostics sémantiques du serveur de langage avant le tour suivant, ce qui le rapproche d’un travail d’agent fondé sur des preuves.
• Les outils de bureau et multimédias s’élargissent. computer_use fonctionne via cua-driver pour les fournisseurs autres que Anthropic, video_generate est unifié derrière des backends enfichables, et vision_analyze envoie les pixels bruts aux modèles qui peuvent réellement voir.

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

Choisissez votre parcours

Fonctionnement de Hermes : le modèle mental

Hermes s’articule autour d’une boucle de conversation unique que n’importe quel 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 prompt_builder.py³
2. Détermine le fournisseur d’exécution via runtime_provider.py — c’est à cette étape que sont choisis votre méthode 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³

Comprendre cette boucle est essentiel, car chaque fonctionnalité — personnalités, mémoire, skills, compression, fallback — se rattache à l’une de ces étapes. Lorsque vous consultez une clé de configuration en vous demandant à quoi elle sert, la réponse est généralement : « c’est un réglage qui agit sur 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, les traitements 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.³ Voilà pourquoi les mêmes commandes slash fonctionnent dans le terminal et dans Telegram : elles sont acheminées depuis un COMMAND_REGISTRY commun 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 à savoir « où Hermes stocke X », la réponse se trouve parmi eux.

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

Hermes Agent v0.20.0 (tag v2026.8.3, 3 août 2026) est la version fonctionnelle actuelle ; les v0.20.1 (13 août) et v0.20.2 (16 août) sont des tags de stabilisation qui s’y ajoutent, tandis que la v0.20.3 (tag v2026.8.16.2, publiée le 17 août) et la v0.20.4 (tag v2026.8.18, 18 août) poursuivent le rythme des versions cumulatives avec leurs propres fenêtres riches en fonctionnalités — consultez la sous-section ci-dessous. La période écoulée depuis la v0.19.0 représente 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 caduques les instructions données par les versions précédentes de ce guide. Lisez-les avant toute autre chose :

• Node 26 est désormais obligatoire. Le programme d’installation impose NODE_VERSION="26" et refuse les runtimes antérieurs en affichant « 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, plus récents, font autorité.²⁴
• pip et Homebrew ont été abandonnés, pas simplement dépréciés. Texte exact : « brew + pip/PyPI wheel channels retired (shell installer / Docker / Nix are the supported channels) ». Si votre installation repose encore sur pip ou brew, elle ne reçoit plus de nouvelles versions.²⁴
• 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 selon ce nouveau plafond. Par défaut, read_file lit également 2 000 lignes au lieu de 500.²⁴

Les autres nouveautés 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 agent à agent, qui répond à la demande de longue date formulée dans l’issue nº 514.²⁴
• Webhooks sortants signés. Auparavant, hermes webhook ne gérait que les flux 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 de nouveautés pour les utilisateurs avancés de la CLI. !command exécute instantanément une commande shell sans consommer un tour de modèle ; /init analyse le projet et crée ou met à jour un 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 à sortie réduite permettant de récupérer les lignes masquées ; Ctrl+S met de côté un prompt en cours de rédaction. hermes import-agent migre une configuration de Claude Code ou de la CLI Codex en une seule commande.²⁴
• Nouveautés liées à la gestion des secrets. Une source de secrets fondée sur une commande auxiliaire et compatible avec chaque coffre-fort, la rotation des tokens en une seule commande avec des erreurs de démarrage exploitables, un cache chiffré de secours facultatif pour Bitwarden, des clés injectées par le coffre-fort et limitées au dossier d’accueil 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.²⁴
• Le bureau est devenu une plateforme à part entière. Des artefacts avec des cartes versionnées et un aperçu interactif isolé, un SDK de plugins avec Kanban comme premier plugin de bureau, un raccourci clavier global de saisie rapide, plusieurs fenêtres d’interface graphique, le mode de backend distant SSH et l’authentification native conforme à la RFC 8252.²⁴

Les versions cumulatives v0.20.3 et v0.20.4 (17–18 août)

Après la v0.20.0, le projet adopte une cadence élevée de versions cumulatives taguées, et les deux plus récentes ne se limitent pas à la stabilisation. Toutes deux précisent que « full curated release notes for this window will ship with v0.21.0 » : les résumés ci-dessous proviennent donc des descriptions de fenêtre propres à ces versions, et non d’une liste de fonctionnalités éditorialisée.²³

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 prend en charge la révision sans état du protocole.²³
• Bot Mode est fourni sous forme de plugin intégré (hermes-bots), qui embarque le protocole principal de collaboration entre coéquipiers.²³
• Un plugin de fournisseur CommandCode rejoint le catalogue des fournisseurs.²³
• Contrats d’exécution Cua Driver 0.20 pour l’utilisation de l’ordinateur, ainsi qu’un renforcement de la gestion du runtime Python dans les sous-processus (isolation de PYTHONHOME/PYTHONPATH).²³
• Fiabilité : autoréparation du planificateur cron (récupération après EMFILE, rapprochement des attributions obsolètes, réarmement des tâches bloquées), correctifs contre la perte de données lors du transfert de sessions, autoréparation de la connexion au gateway distant depuis le bureau et vague de portages dans l’écosystème (analyse de sécurité à l’installation des plugins, /worktree, conservation des modifications manuelles avec /rollback, lecture des fichiers UTF-16).²³

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

• La surface vitrée de l’application de bureau : travail sur le verre mat et la 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 correctifs pour les conversations de groupe de Bot Mode (tours prolongés des membres, rendu Markdown, routage entre machines).²³
• Analyse consultative NVIDIA SkillEvaluator Tier 1 lors de l’installation des skills — des contrôles 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 pour les exécutions manuelles, signalement des déclenchements manqués), correctifs de SessionDB concernant le thread de la boucle d’événements et les conflits d’accès, transparence de hermes update au sujet des branches mises en attente et notifications natives du système d’exploitation pour Kanban.²³

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 v0.19.0 (la version Quicksilver)

Hermes Agent v0.19.0 (tag v2026.7.20, 20 juillet 2026) tire son nom de la vitesse propre au dieu messager : la colonne vertébrale de cette version est sa réactivité brute, avec une réduction d’environ 80 % du délai avant le premier token au premier tour sur toutes les plateformes. Autour de ce cœur se trouvent la facturation dans le terminal, des sources de secrets via gestionnaire de mots de passe, les approbations intelligentes par défaut, des sous-agents observables et une livraison des réponses résistante aux crashs. La période depuis v0.18.0 est la plus importante du projet à ce jour : environ 2 245 commits, environ 1 065 PR fusionnées, environ 3 300 issues clôturées et plus de 450 contributeurs de la communauté.²⁵

• Environ 80 % plus rapide jusqu’au premier token, partout. Le délai soumission→envoi à froid est passé d’environ 4,3 s à environ 0,9 s dans le CLI, le gateway, le TUI, l’application desktop et cron — la détection des capacités Discord a été retirée du chemin critique, le test Ollama est ignoré pour les providers connus comme non-Ollama, et le travail bloquant a été supprimé de l’initialisation de l’agent. La latence perçue a également fait l’objet d’une amélioration : les modèles de raisonnement diffusent désormais leur réflexion en direct par défaut (display.show_reasoning est activé), et la boîte de réponse s’affiche token par token plutôt que ligne par ligne.²⁵
• Vague de rendu desktop et TUI. L’application desktop a bénéficié d’une optimisation de vitesse d’environ 20 PR : 14× moins de CPU dans le séparateur Markdown en streaming grâce à l’analyse incrémentale des blocs, des diffs virtualisés dans le panneau de révision, un changement de session fluide sur les longues transcriptions, et plus aucun nouveau rendu de la barre latérale ou des lignes d’outils à chaque token. Le TUI affiche désormais le Markdown diffusé progressivement, bloc par bloc.²⁵
• Les installations pip et Homebrew sont dépréciées. Les deux chemins ont été signalés comme installations « legacy non prises en charge », avec une suppression prévue. Cette suppression a depuis eu lieu dans v0.20.0 — les canaux brew et les wheels pip/PyPI sont retirés, ne laissant que l’installateur shell, Docker et Nix parmi les canaux pris en charge.²⁵²⁴
• Les secrets peuvent provenir de votre gestionnaire de mots de passe. Une nouvelle interface SecretSource extensible récupère les secrets depuis Bitwarden et 1Password (références op://) au chargement, avec plusieurs coffres activés simultanément, une priorité déterministe, des avertissements de conflit et la provenance de chaque variable — les clés API n’ont plus besoin de se trouver dans un .env en texte brut. Les futurs providers de coffres s’ajoutent 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 évaluateur LLM indépendant l’examine au lieu de vous demander une confirmation pour chacune — et 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 la raison de votre refus afin que l’agent corrige sa trajectoire, et l’action d’approbation pre_tool_call du plugin (réintroduite avec des clés de règle) soumet un appel d’outil à une validation humaine.²⁵
• Facturation dans le terminal : /subscription et /topup. Gérez votre formule Nous Portal sans quitter le terminal — consultez votre formule et votre quota restant, prévisualisez précisément le coût d’une mise à niveau ou la date d’effet d’une rétrogradation, puis appliquez-la avec possibilité d’annulation. L’application desktop gagne un onglet de paramètres de facturation correspondant.²⁵
• Observez le travail des sous-agents ; ne perdez jamais une réponse terminée. Les envois delegate_task renvoient des fichiers de transcription en direct que vous pouvez suivre avec tail -f dès le lancement des sous-agents — chaque appel d’outil, résultat et réponse diffusée, avec un journal lisible par humain pour chaque enfant. Les finalisations de délégation en arrière-plan persistent après les redémarrages, et les réponses finales du gateway sont consignées dans un registre d’obligations de livraison dans state.db, puis renvoyées au prochain démarrage si le gateway s’arrête pendant l’envoi. L’option de configuration max_async_children est dépréciée au profit de plafonds de concurrence unifiés pour la délégation.²⁵
• Un gateway, plusieurs profiles. Un seul gateway multiplexé partageant un token de bot peut router des guilds, channels ou threads spécifiques vers différents profiles — chacun avec une configuration, des skills, une mémoire et des secrets entièrement isolés — avec une surcharge GATEWAY_MULTIPLEX_PROFILES. L’index de routage a été déplacé dans state.db ; sessions.json est désormais un miroir legacy facultatif.²⁵
• Vague de providers et de modèles. Fireworks AI arrive avec une prise en charge de premier plan (estimation des coûts, 2e position dans le sélecteur de provider), rejoint par DeepInfra et Upstage Solar. Les catalogues ajoutent GPT-5.6 (Sol/Terra/Luna + Pro, reliés de bout en bout), grok-4.5 (GA), kimi-k3 (kimi-k2.x retiré) et Claude Sonnet 5 entièrement intégré. Un indicateur enabled: false par provider et la configuration excluded_providers retirent les providers inutilisés des sélecteurs et de la résolution /model.²⁵
• L’effort de raisonnement devient un réglage. De nouveaux niveaux d’effort max et ultra arrivent sur toutes les surfaces, avec des surcharges par modèle dans la configuration, un effort par slot dans les préréglages MoA (les conseillers réfléchissent intensément, le synthétiseur reste rapide), un effort par tâche pour les modèles auxiliaires et /reasoning, limité à la session, dans le CLI.²⁵
• Surface CLI et MCP. hermes sessions export écrit aux formats Markdown, Quarto, HTML, prompt-only et trace Hugging Face, avec un nettoyage --redact facultatif ; /model --once fournit une surcharge de modèle pour un seul tour ; les invocations de slash-skill se cumulent (/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 sans interface ; et les outils MCP adoptent la convention de nommage mcp__server__tool.²⁵

Si vous passez de v0.18.x, deux changements méritent votre attention avant tout le reste : une installation pip ou Homebrew avertit désormais qu’elle est une installation legacy non prise en charge (migrez vers l’installateur en une ligne), et max_async_children est déprécié au profit des plafonds de concurrence unifiés pour la délégation. Tout le reste est additif — les principales raisons de mettre à niveau sont la réduction d’environ 80 % de la latence au premier tour, les approbations intelligentes et le registre de livraison qui rend les réponses terminées résistantes aux crashs.

Nouveautés de v0.18.0 (la version Judgment)

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 de déclarer sa réussite, et le raisonnement d’ensemble que vous pouvez réellement examiner. Cette version clôt également l’intégralité du backlog P0/P1 — environ 692 éléments de plus haute priorité résolus en douze jours.²²

• Mixture-of-Agents comme modèle de premier plan. MoA est désormais sélectionnable comme n’importe quel autre modèle dans toutes les interfaces, et le raisonnement d’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 observer l’ensemble réfléchir au lieu de recevoir une réponse fusionnée opaque.²²
• Contrats de finalisation pour /goal. L’agent vérifie son propre travail en exécutant les vérifications du projet avant de signaler un objectif comme terminé, au lieu de simplement déclarer sa réussite — un jugement appliqué à lui-même.²²
• /learn — décrivez n’importe quoi pour en faire une skill. Transformez un workflow en skill réutilisable en le décrivant ; les skills générées respectent automatiquement les conventions CONTRIBUTING.md du dépôt.²²
• Chronologie /journey. Un historique visuel de la mémoire et des skills au fil du temps, avec édition, ainsi qu’un graphe de mémoire dans l’application desktop.²²
• Éventail de sous-agents en arrière-plan. Déléguez plusieurs tâches qui s’exécutent simultanément sans bloquer la conversation — le sous-agent unique en arrière-plan de v0.17.0 devient une flotte.²²
• Projects desktop. Des Projects de code de premier plan avec un modèle d’organisation project/repo/lane.²²
• Gateway avec réduction à zéro. Les gateways peuvent devenir inactifs lorsqu’ils sont au repos et coordonner les vidages pour des déploiements sans interruption — important pour toute personne exécutant Hermes comme service toujours actif.²²
• Prise en charge de Google Vertex AI. Accès à Gemini via des comptes de service GCP avec actualisation automatique des tokens OAuth2, qui rejoint le catalogue de providers.²²
• Commande d’éditeur /prompt. Ouvre $EDITOR pour rédiger des prompts sur plusieurs lignes au lieu de lutter avec la ligne de saisie.²²

Si vous passez de v0.17.x, rien ici ne casse le CLI. Les principales raisons de mettre à niveau sont les contrats de finalisation (des objectifs qui se vérifient eux-mêmes), MoA de premier plan avec des ensembles inspectables, et /learn pour capturer des skills.

Nouveautés de v0.17.0 (la version Reach)

Hermes Agent v0.17.0 (tag v2026.6.19, 19 juin 2026) tire son nom de l’étendue que l’agent couvre désormais — nouveaux canaux de messagerie, nouveaux fournisseurs de modèles et contrôle plus approfondi du bureau et du dashboard. Elle complète v0.16.x ; la surface CLI reste inchangée.²¹

• Nouveaux canaux de messagerie. iMessage fonctionne désormais sans relais Mac via Photon Spectrum (code d’appareil OAuth, hermes photon login) ; le WhatsApp Business Cloud API est un adaptateur Meta officiel qui remplace l’exigence d’un processus bridge ; SimpleX gagne les groupes, les pièces jointes natives, le traitement par lots de texte et l’acceptation automatique ; et Raft rejoint le projet en tant que plugin de plateforme inclus, avec une conception de canal de réveil garantissant la confidentialité par contrat.²¹
• Nouveaux modèles et fournisseurs. Le catalogue ajoute z-ai/glm-5.2 (contexte de 1 M), anthropic/claude-fable-5, laguna-m.1, nemotron-3-ultra et grok-composer-2.5-fast (le modèle de Cursor via xAI OAuth, contexte de 200 k). La valeur par défaut de xAI devient grok-build-0.1, et les modèles adaptatifs Anthropic suivent désormais le contrat de réflexion moderne (ils n’envoient jamais de champ reasoning).²¹
• Bureau et dashboard. Le bureau ajoute des sous-agents en arrière-plan avec un streaming en direct « watch-windows » de l’activité déléguée (delegate_task(background=true)), un sélecteur de modèle Composer, des raccourcis clavier reconfigurables, des notifications OS natives, des brouillons de compositeur par fil, des thèmes VS Code Marketplace, ainsi qu’une interface en japonais et en chinois traditionnel. Le dashboard ajoute un générateur de profile complet (modèle/skills/MCPs sans modifier config.yaml), un sélecteur global de profile, un Skills Hub remanié avec analyse de sécurité, des Automation Blueprints (modèles paramétrables pour les formulaires, commandes slash, conversations et documents), ainsi qu’une connexion sécurisée qui renvoie 401 derrière la passerelle OAuth.²¹
• Skills et outils. image_generate peut désormais modifier et transformer une image source, et non seulement en créer une à partir de rien, chez tous les fournisseurs d’images pris en charge ; l’outil memory reçoit un tableau operations pour les ajouts/remplacements/suppressions atomiques par lots en un seul appel ; un nouveau skill simplify-code exécute en parallèle une passe de revue et de nettoyage par trois agents, contrôlée par un niveau de risque de type Chesterton’s Fence ; et le booléen write_approval remplace le paramètre ternaire write_mode.²¹
• Architecture. Les sous-agents en arrière-plan renvoient immédiatement un handle et réinjectent leur résultat sous forme de nouveau tour ; un gestionnaire d’élicitation MCP permet une confirmation au milieu d’un appel d’outil, et les outils MCP qui se connectent tardivement sont exposés entre les tours (sans risque pour le cache) ; cron devient un CronScheduler enfichable avec un fournisseur de cron géré Chronos ; et un nouveau périmètre Managed (/etc/hermes) permet à un administrateur d’épingler une configuration immuable pour les utilisateurs, en parallèle d’un relais Gateway-Gateway pour les topologies à plusieurs gateways.²¹
• 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, de sorte que la curation habituelle en arrière-plan ne consomme aucun token.²¹
• Sécurité. v0.17.0 corrige un contournement de liste de refus d’échappement shell, échoue de manière sûre lorsque des modules d’approbation ou des adaptateurs gateway de stratégie propre sont absents, assainit l’environnement des sous-processus de scripts de tâches cron, masque les secrets dans les dumps de débogage des requêtes, examine les configurations stdio MCP à la recherche de motifs d’exfiltration et met à niveau urllib3 et PyJWT pour corriger des CVE.²¹

Si vous effectuez une mise à niveau depuis v0.16.x, rien ici ne casse la CLI ; il s’agit de nouveaux canaux, modèles et surfaces autour du même agent. Les adaptateurs iMessage sans relais et WhatsApp officiel, ainsi que le périmètre Managed destiné aux administrateurs, sont les principales raisons de procéder à la mise à niveau.

Nouveautés de v0.16.0 (la version Surface)

Hermes Agent v0.16.0 (tag v2026.6.5, 5 juin 2026) tire son nom des nouvelles surfaces qu’elle place devant l’agent centré sur la CLI. Le point essentiel est que Hermes ne se limite plus au terminal.²⁰

• Application de bureau native. Hermes Desktop est une nouvelle application Electron pour macOS, Linux et Windows, avec installation en un clic et mise à jour automatique depuis l’application. Elle vous offre 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 de sessions avec archivage et recherche, ainsi qu’un sélecteur de modèle dans la barre d’état. Elle peut se connecter à un gateway Hermes distant via un WebSocket sécurisé, avec authentification via OAuth ou nom d’utilisateur/mot de passe, des hôtes distants par profile et des sessions simultanées sur plusieurs profiles reliées par des références @session inter-profiles. L’interface de bureau inclut également une traduction complète en chinois simplifié (简体中文) grâce à une couche i18n typée (display.language ; l’anglais reste la langue par défaut).²⁰
• Panneau d’administration dans le navigateur. Le dashboard web local passe d’une vue d’état à un panneau d’administration complet : catalogue MCP avec bascules d’activation/désactivation, gestion des identifiants, création de webhooks et de hooks, configuration de la mémoire, contrôles du gateway, ainsi qu’une page System avec vérification avant mise à jour et Debug Share en un clic. Une nouvelle page Channels configure depuis le navigateur chaque plateforme de messagerie du gateway (Telegram, Discord, Slack et les autres). L’authentification est désormais enfichable : connexion par nom d’utilisateur/mot de passe, fournisseur OIDC générique auto-hébergé, hermes dashboard register pour un client OAuth auto-hébergé et rotation de sessions par refresh token.²⁰
• Nouvelles CLI et commandes slash. /undo [N] restaure les N derniers tours utilisateur avec préremplissage et suppression réversible, et fonctionne dans la CLI, le TUI et sur les plateformes de messagerie. Une interface par défaut configurable (cli ou tui) arrive avec le remplacement --cli ; le TUI gagne une commande /model unifiée et un panneau Sessions. hermes portal est un alias lisible par les humains pour le flux d’intégration Nous Portal, avec de nouveaux parcours initiaux Quick Setup ou Full Setup, et deux diagnostics font leur apparition : hermes prompt-size et hermes sessions optimize.²⁰
• Nouveaux modèles et fournisseurs. Le sélecteur ajoute deepseek-v4-flash, MiniMax-M3 (contexte de 1 M, fournisseurs MiniMax natifs), qwen3.7-plus (Nous + OpenRouter) et gemini-3.5-flash (Gemini OAuth + clé API). Un fournisseur xAI Grok OAuth de premier plan rejoint le lanceur de bureau, le sélecteur de modèles devient flou sur toutes les surfaces, les fournisseurs à plusieurs endpoints sont regroupés sur une seule ligne et l’actualisation du catalogue passe d’un rythme quotidien à horaire.²⁰
• 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 d’éléments vers les options et ajoute une barrière de pertinence frontmatter environments: (kanban/docker/s6) qui garde les skills propres à un contexte hors de l’index jusqu’à leur demande. NVIDIA/skills est désormais une source Skills Hub fiable par défaut, aux côtés d’OpenAI, Anthropic et HuggingFace. Les outils MCP et de plugin gagnent une divulgation progressive (à portée limitée) des outils, et un bug MCP qui signalait un faux succès OAuth lorsqu’aucun token n’était obtenu est corrigé.²⁰
• Sécurité. v0.16.0 épingle une version corrigée de Starlette (≥1.0.1) pour CVE-2026-48710 (BadHost), déplace les vérifications d’URL SSRF hors de la boucle d’événements dans les chemins asynchrones, retire le bearer token d’inférence Bedrock de l’environnement des sous-processus, ajoute bws_cache.json à la protection de lecture pour la sûreté des fichiers, ajoute docker restart/stop/kill à la liste des motifs dangereux et assainit les caractères Unicode invisibles dans le contenu des skills validés. La version a corrigé 2 problèmes P0 et 62 problèmes P1, dont 16 étiquetés sécurité.²⁰

Si vous effectuez une mise à niveau depuis v0.15.x, rien de tout cela ne constitue une rupture pour la CLI elle-même ; ce sont des surfaces et fournisseurs complémentaires autour du même agent. L’application de bureau et le panneau d’administration justifient la mise à niveau si vous souhaitez utiliser Hermes avec des utilisateurs non habitués au terminal ou administrer un gateway distant depuis un navigateur.

Installation

L’installateur en une ligne est 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 v0.19.0. Le package PyPI introduit par la v0.14.0 (pip install hermes-agent) et la formule Homebrew sont désormais signalés comme des installations « legacy non prises en charge » — chaque interface affiche un avertissement (sans bloquer) lorsque Hermes en détecte une, et l’arrêt de la publication sur PyPI/Homebrew est prévu. Si vous avez installé Hermes via pip ou brew, migrez vers l’installateur ci-dessus.²⁵

Fonctionne sous Linux, macOS, WSL2 et Android/Termux (l’installateur détecte automatiquement Termux et bascule vers un bundle Android testé).⁷ Windows natif est désormais une plateforme Tier 1, et non plus la bêta précoce livrée avec la v0.14.0 — installez-le avec iex (irm https://hermes-agent.nousresearch.com/install.ps1). Une réserve explicitement indiquée dans la documentation : la prise en charge de macOS est réservée à Apple Silicon, et les Mac Intel ne sont pas pris en charge.²⁴ Historiquement, la v0.14.0 a ajouté la prise en charge native de Windows en bêta précoce via un installateur PowerShell, mais WSL2 reste la recommandation la plus sûre pour une utilisation en production, jusqu’à ce que la voie Windows gagne en maturité.¹⁹

Une fois l’installation terminée :

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

Le seul prérequis est git. L’installateur provisionne automatiquement Python 3.11 via uv (sans sudo), Node.js 26 (pour l’automatisation du navigateur et le pont WhatsApp), ripgrep et ffmpeg. Node 26 est une exigence minimale stricte depuis la v0.20.0 — l’installateur refuse toute version plus ancienne et installe à la place une version de Node gérée par Hermes.²⁴⁷

Vérifier l’installation

hermes version      # Check version
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 exactement ce qui manque et comment le corriger.⁷ hermes dump est la commande de diagnostic à coller dans une issue GitHub ou un fil Discord lorsque vous demandez de l’aide — elle fournit un résumé en texte brut de toute votre configuration, avec les secrets 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 — le flux manuel est documenté étape par étape dans le guide d’installation upstream.⁷ Voici les principaux extras facultatifs que vous pouvez combiner avec uv pip install -e ".[<extras>]" :

La commande d’installation 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

Cela s’explique par le fait que .[all] sur Android récupère faster-whisper via l’extra voice, qui dépend de wheels ctranslate2 non publiées pour Android.⁷

Authentification et fournisseurs

Hermes prend en charge environ 22 fournisseurs de premier plan ainsi que des endpoints personnalisés (v0.19.0 ajoute Fireworks AI, DeepInfra et Upstage Solar), et trois parcours d’authentification distincts. Voici l’ensemble des possibilités d’authentification, organisées par parcours afin que vous puissiez trouver celui qui correspond à votre situation.

Les trois parcours d’authentification

Chaque fournisseur dans Hermes relève de l’un des trois modèles d’authentification suivants :

Parcours 1 — clé API dans .env. Placez votre clé dans ~/.hermes/.env et Hermes la lit au démarrage. Utilisé par OpenRouter, AI Gateway, z.ai/GLM, Kimi/Moonshot, MiniMax (et MiniMax China), Alibaba Cloud/DashScope, Kilo Code, OpenCode Zen, OpenCode Go, DeepSeek, Hugging Face, Google/Gemini et la plupart des fournisseurs tiers.² Depuis v0.19.0, la clé ne doit plus nécessairement se trouver dans un fichier en texte clair : une interface SecretSource extensible peut récupérer les secrets depuis Bitwarden ou 1Password (références op://) au chargement, avec plusieurs coffres activés simultanément, un ordre de priorité déterministe, des avertissements de conflit et une provenance par variable — .env reste la solution de repli. (Cela se distingue du jeton d’amorçage Bitwarden Secrets Manager de v0.15.0, qui regroupait les clés des fournisseurs derrière un seul jeton ; SecretSource remplace le fichier en texte clair lui-même, et les futurs fournisseurs de coffres s’ajoutent comme plugins.)²⁵

Parcours 2 — OAuth via hermes model ou hermes auth. Lance un flux de code d’appareil, ouvre un navigateur, stocke les identifiants dans ~/.hermes/auth.json (et peut importer des identifiants existants depuis des outils comme Claude Code ou Codex CLI). 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é. Configurez-le une fois via hermes model → Custom endpoint, puis il est conservé dans config.yaml.²

La matrice complète des fournisseurs

Voici la liste complète des fournisseurs de premier plan, avec le processus de configuration exact pour chacun.²

À partir de v0.19.0, vous pouvez également retirer les fournisseurs que vous n’utilisez pas : un indicateur enabled: false par fournisseur et une clé de configuration excluded_providers les retirent des sélecteurs /model et de la résolution intégrée des fournisseurs.²⁵

Anthropic : trois méthodes d’authentification

Anthropic dispose de sa propre section, car Hermes prend en charge trois parcours distincts vers Claude, et choisir le bon a son importance. 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 propre magasin d’identifiants de Claude Code plutôt que de copier le jeton dans ~/.hermes/.env. Les identifiants Claude pouvant être actualisés restent ainsi actualisables.² Si vous utilisez déjà Claude Code sur la même machine, c’est le parcours le plus propre.

Pour fixer Anthropic de façon permanente dans config.yaml :

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

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

GitHub Copilot : deux modes

Copilot est pris en charge selon deux modes : API Copilot direct (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

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

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

Fournisseurs d’IA chinois (prise en charge de premier plan)

Hermes prend en charge nativement z.ai/GLM, Kimi/Moonshot, MiniMax (endpoints mondiaux + China) et Alibaba Cloud avec des identifiants de fournisseurs 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 avec les 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 fournisseur z.ai/GLM, Hermes sonde plusieurs endpoints (mondial, China, variantes de programmation) afin d’en trouver un qui accepte votre clé API. L’endpoint fonctionnel est mis en cache automatiquement — aucun GLM_BASE_URL n’est nécessaire pour la plupart des utilisateurs.²

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 à chaque requête afin de l’acheminer vers le même serveur pendant une session de conversation, en réutilisant les prompts système et l’historique mis en cache.² Automatique ; aucune configuration 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 de faire tourner plusieurs clés API ou jetons OAuth pour un même fournisseur — utile pour répartir les limites de débit entre plusieurs clés sans modifier le code.⁶ Les commandes historiques hermes login / hermes logout ont été supprimées ; utilisez hermes auth à la place.⁶

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 diriger Hermes.²

Configuration interactive (recommandée) :

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

config.yaml manuel :

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

Les deux approches sont conservées dans config.yaml, qui constitue la source de vérité unique pour le modèle principal, le fournisseur et l’URL de base.² Les variables d’environnement historiques OPENAI_BASE_URL et LLM_MODEL ne sont plus lues pour la configuration du modèle principal — utilisez hermes model ou modifiez directement config.yaml.² (OPENAI_BASE_URL + OPENAI_API_KEY restent néanmoins pris en charge comme solution de repli pour le chemin de routage auxiliaire provider: "main" ; ne les supprimez donc pas aveuglément si vous les utilisez à cet endroit.)⁴

Changer 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 le API /v1/models de votre endpoint et sélectionne automatiquement le modèle si un seul est chargé — utile pour les serveurs locaux exécutant un seul modèle.²

Serveurs LLM locaux (modèles de configuration)

La documentation en amont contient des guides de configuration complets pour Ollama, vLLM, SGLang, llama.cpp et LM Studio. Voici les principales commandes que vous exécuterez réellement. Chacune est conçue pour fournir un endpoint fonctionnel vers lequel Hermes peut pointer.²

Ollama — le parcours local le plus simple, sans 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 critique avec Ollama : Ollama utilise par défaut des longueurs de contexte très faibles (4 096 jetons avec moins de 24 Go de VRAM). Vous devez l’augmenter via OLLAMA_CONTEXT_LENGTH ou un Modelfile — le API compatible avec OpenAI n’accepte pas de longueur de contexte depuis le client, donc Hermes ne peut pas la définir pour vous.² Pour un usage d’agent, définissez au moins 16k–32k.

vLLM — service GPU hautes performances :

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 indicateurs, les appels d’outils seront renvoyés sous forme de texte brut.²

SGLang — service rapide avec RadixAttention pour la réutilisation du 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 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 lui, llama-server ignore entièrement le paramètre tools et le modèle tente d’appeler les outils en écrivant JSON dans le texte de sa réponse — ce que Hermes ne peut pas analyser comme de véritables appels d’outils.²

LM Studio — application de bureau avec GUI :

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.² Dirigez ensuite hermes model vers http://localhost:1234/v1.

Piège critique avec LM Studio : LM Studio lit la longueur de 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 de contexte dans les paramètres du modèle LM Studio — cliquez sur l’icône d’engrenage à côté du sélecteur de modèles, 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 travaillez avec 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

Basculez ensuite entre eux en cours de session avec 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 des fournisseurs personnalisés nommés depuis le menu interactif hermes model.²

Architecture de fournisseurs extensible (v0.13.0+)

v0.13.0 inclut une ABC ProviderProfile ainsi qu’un répertoire plugins/model-providers/, afin que des fournisseurs d’inférence tiers puissent s’ajouter sans modifier le cœur.¹⁸ Si un fournisseur propose un mode API compatible avec OpenAI, Anthropic ou Codex, vous pouvez implémenter une sous-classe 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 via 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’extension des fournisseurs dans v0.13.0 : au lieu de modifier le code central pour ajouter un fournisseur, vous publiez un plugin.

Proxy local compatible avec OpenAI (v0.14.0+)

hermes proxy expose un endpoint local compatible avec OpenAI, soutenu par le 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 style OpenAI, notamment Codex CLI, Aider, Cline, Continue ou des scripts personnalisés, peuvent réutiliser votre authentification Hermes fondée sur un abonnement sans clé API distincte. Considérez le proxy comme une infrastructure locale de développement : associez-le volontairement, ne l’exposez pas largement et gardez à l’esprit les conditions propres à chaque fournisseur.

Détection de la longueur de contexte

Deux paramètres sont constamment confondus, selon la documentation en amont :²

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

Définissez context_length lorsque la détection automatique évalue incorrectement la taille de la fenêtre :

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

Hermes utilise une chaîne de résolution multi-source 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 communautaire de plus de 3 800 modèles) → valeurs de repli (128K).² Le système tient compte du fournisseur, de sorte que le même modèle peut avoir différentes limites de contexte selon celui qui le sert (par exemple, claude-opus-4.6 offre 1M directement sur Anthropic, mais 128K sur GitHub Copilot).²

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

Hermes ne vous limite pas à un modèle chez un seul fournisseur. Le routage intelligent des modèles est l’ensemble des mécanismes qui déterminent quel fournisseur et quel modèle répondent réellement à 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 primaire échoue, et les emplacements auxiliaires ci-dessous acheminent indépendamment les tâches secondaires vers des modèles moins coûteux que votre modèle principal.²⁶ Configurez ces trois éléments ensemble – ils font la différence entre un agent qui s’arrête sur une limite de débit et un agent qui continue à travailler.

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

Modèle de repli. Configurez un provider:model de secours vers lequel Hermes bascule automatiquement lorsque votre modèle principal échoue (limites de débit, erreurs de 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 le modèle et le fournisseur en cours de session sans perdre votre conversation. Il ne se déclenche qu’une 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 légers « auxiliaires » pour les tâches secondaires : analyse d’images, résumé de pages web, analyse de captures d’écran de navigateur, classification des validations de commandes dangereuses, compression du contexte, résumé des recherches de session, correspondance des skills, distribution d’outils MCP et vidage de la mémoire.⁴ Par défaut, ils utilisent Gemini Flash par détection automatique (OpenRouter → Nous → Codex).

Vous pouvez configurer le modèle et le fournisseur utilisés par chaque tâche auxiliaire. Chaque emplacement auxiliaire utilise les mêmes trois paramètres : provider, model, base_url.⁴

auxiliary:
  vision:
    provider: "auto"                # "auto", "openrouter", "nous", "codex", "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: 30
    download_timeout: 30
  web_extract:
    provider: "auto"
    model: ""
    timeout: 360
  approval:
    provider: "auto"
    model: ""
    timeout: 30
  compression:
    timeout: 120
  session_search: { provider: "auto", model: "", timeout: 30 }
  skills_hub:    { provider: "auto", model: "", timeout: 30 }
  mcp:           { provider: "auto", model: "", timeout: 30 }
  flush_memories:{ provider: "auto", model: "", timeout: 30 }

L’option de fournisseur "main" signifie « utiliser le fournisseur employé par mon agent principal » — elle n’est valide que dans les configurations auxiliary:, compression: et fallback_model:. Elle n’est pas valide pour votre paramètre model.provider de niveau supérieur. Si vous utilisez un endpoint personnalisé compatible avec OpenAI comme modèle principal, définissez provider: custom dans votre section model:.⁴

Pourquoi c’est important : si vous n’avez configuré que Anthropic OAuth (sans clé OpenRouter), votre vision, les résumés web et la compression se dégraderont ou échoueront, car la chaîne de repli auxiliaire par défaut essaie d’abord OpenRouter. Ajoutez une OPENROUTER_API_KEY pour les tâches auxiliaires, ou reconfigurez chaque emplacement auxiliaire pour utiliser votre fournisseur principal :

auxiliary:
  vision:
    provider: "main"
  web_extract:
    provider: "main"

C’est le piège le plus courant pour les nouveaux utilisateurs de Hermes : « mes fonctionnalités ne marchent silencieusement pas ».

Système de configuration

Hermes dispose d’un système de configuration en couches. Il est essentiel d’en comprendre la priorité, car les couches supérieures remplacent les couches inférieures, et l’une d’elles est un registre global de providers que vous ne pouvez pas voir dans config.yaml.

Organisation des fichiers de configuration

D’après la documentation amont, 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 vs .env — lorsque les deux sont définis, config.yaml l’emporte pour les paramètres non secrets.⁴ La règle est la suivante : - Secrets (clés API, tokens de bot, mots de passe) → .env - Tout le reste (modèle, backend de 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 style 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 que votre fichier ne contient pas encore.⁶

Priorité de la configuration

Hermes charge la configuration depuis plusieurs sources. Lorsque plusieurs sources définissent la même valeur, la source la plus prioritaire l’emporte :⁴

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

Les flags CLI l’emportent toujours pour cette invocation unique. config.yaml reste la source de vérité à long terme.

Localisation (v0.13.0+)

La v0.13.0 a ajouté 7 locales pour les messages CLI et gateway : chinois (simplifié), japonais, allemand, espagnol, français, ukrainien et turc.¹⁸ La v0.14.0 localise toutes les commandes gateway et le tableau de bord web, ajoute 8 locales supplémentaires et porte le total à 16.¹⁹ La documentation n’est actuellement localisée qu’en zh-Hans. La locale est déterminée à partir des variables d’environnement LC_ALL / LANG ou d’une clé explicite locale: dans config.yaml. L’anglais reste la valeur par défaut et la source de vérité pour toute chaîne qu’une traduction ne couvre pas encore.

Profiles — Plusieurs instances Hermes isolées

Les profiles vous donnent plusieurs instances Hermes isolées, chacune avec sa propre configuration, ses sessions, skills, mémoire et PID gateway. C’est ainsi que vous exécutez « Hermes professionnel » et « Hermes personnel » côte à côte, sans que l’un puisse voir 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 possède son propre HERMES_HOME (~/.hermes-<name>/ par défaut), ce qui permet à plusieurs profiles d’exécuter le gateway simultanément sans interférer les uns avec les autres.⁶³

Commandes CLI

Cette section constitue la référence pratique des commandes CLI de premier niveau. Pour la référence faisant autorité, dérivée du code, consultez la référence des commandes CLI.⁶

Options globales

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

Commandes de premier niveau

hermes chat — Le principal point d’entrée

hermes sans argument ouvre un chat interactif. hermes chat est la forme explicite avec options :⁶

hermes chat -q "Summarize the latest PRs"           # One-shot, non-interactive
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 clés :

hermes setup — Assistant complet

Exécute l’assistant de configuration complet ou accède directement à une section :⁶

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 horaire.⁶

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, répartition des tools, cycle de vie des sessions, INFO+) - errors.log — avertissements et erreurs uniquement (un sous-ensemble filtré de agent.log) - gateway.log — activité du gateway de messagerie (connexions aux plateformes, répartition, webhooks)

La rotation est automatique via 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, l’état du service et peut tenter des réparations automatiques avec --fix.⁶

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

Commandes Slash

Les commandes Slash s’exécutent dans 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 session

Configuration et modèle

La commande /model est l’outil principal pour changer de provider au cours d’une 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 remplacement de modèle pour un tour qui revient automatiquement à votre modèle précédent après la réponse.²⁵

Outils, skills et informations

Commandes Slash de skills dynamiques

Chaque skill installé est automatiquement exposé comme 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 invocations de slash-skill s’empilent : /skill-a /skill-b do XYZ charge les deux skills dans l’ordre lors d’un même tour, avec saisie semi-automatique et texte fantôme pour les noms chaînés.²⁵

Vous pouvez également définir des commandes rapides dans config.yaml afin d’associer 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 : saisir /h correspond à /help, tandis que /mod correspond à /model. Lorsqu’un préfixe est ambigu, le premier enregistrement dans l’ordre du registre l’emporte. Les noms complets de commande et les alias enregistrés ont toujours priorité sur les correspondances par préfixe.⁹

Commandes spécifiques 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 de session
• /sethome (alias /set-home) — désigner 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 votre motif de refus à l’agent afin qu’il corrige sa trajectoire 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 (paginés)

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

Outils et toolsets

Hermes est livré avec un vaste registre d’outils intégrés couvrant la recherche sur le Web, l’automatisation de navigateur, l’exécution dans le terminal, l’édition de fichiers, la mémoire, la délégation, l’entraînement RL, 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 de toolsets courants incluent 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 via /tools disable <name> et /tools enable <name>, ce qui réinitialise la session afin que le nouvel ensemble d’outils prenne effet.⁹

Backends de terminal

L’outil de terminal peut exécuter des commandes dans six environnements différents :¹⁰

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

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

Backend SSH (recommandé pour la 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, 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, fichiers et configurations persistent entre les sessions.¹⁰

Tous les backends de conteneurs s’exécutent avec un durcissement de sécurité : système de fichiers racine en lecture seule (Docker), toutes les capacités Linux supprimées sauf DAC_OVERRIDE, CHOWN et FOWNER, aucune élévation de privilèges, limites de PID (256 processus), isolation complète des espaces de noms, espace de travail persistant via des 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) active les outils CLI interactifs comme Codex et Claude Code.¹⁰

Sudo

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

Kanban multi-agent (v0.13.0+)

La v0.13.0 fait de la collaboration multi-agent une primitive de premier plan : un tableau Kanban durable qui suit les tâches, leur état et l’identité des workers entre les agents et après les redémarrages.¹⁸ C’est ce tableau qui permet à un essaim de workers Hermes de réellement terminer le travail, au lieu de rester bloqué sur des passations défaillantes.

Le tableau Kanban s’associe naturellement à /goal (boucle Ralph à cible verrouillée) pour l’aspect objectif, ainsi qu’à l’outil delegate_task existant pour la sémantique de création. Il en résulte un modèle d’essaim où chaque agent partage une source de vérité unique concernant ce qu’il faut faire ensuite, qui s’en charge et ce qui est bloqué.

Qu’est-ce qu’un essaim Hermes ?

Un essaim rassemble plusieurs workers Hermes exécutés en parallèle sur un même tableau Kanban partagé. Ce n’est pas un sous-système distinct à activer – c’est ce que le tableau rend possible. Le tableau fournit la seule chose que des agents parallèles ne peuvent pas se fournir eux-mêmes : une réponse unique et faisant autorité à quelle tâche dois-je prendre ensuite, et quelqu’un s’en occupe-t-il déjà ?

La v0.15.0 a fait évoluer ce modèle d’un simple pattern à une topologie prise en charge, en ajoutant une topologie d’essaim pour la coordination de workers parallèles, la décomposition automatique d’un objectif de haut niveau en sous-tâches, des remplacements de modèle par tâche, des tâches planifiées et la gestion des worktrees afin que les workers parallèles n’entrent pas en conflit dans le même checkout.²⁸

Dans la pratique : donnez un objectif à l’essaim, laissez la décomposition automatique le répartir en tâches sur le tableau, puis laissez les workers les réclamer, les exécuter et renvoyer les résultats. Le budget de nouvelles tentatives est défini par tâche (max_retries), afin qu’une sous-tâche fragile ne consomme pas toute la tolérance de l’exécution. Comme le tableau est durable, un essaim survit aux redémarrages – les workers se reconnectent et reprennent à partir du même état.

Un essaim ne vaut que par sa décomposition. Le tableau coordonne les workers ; il ne transforme pas un objectif mal découpé en bon objectif. Les tâches qui partagent un état caché continueront à se heurter, avec ou sans worktrees.

Système de skills

Les skills sont des documents de connaissances à la demande que l’agent peut charger lorsque nécessaire. Ils suivent un modèle de divulgation progressive afin de réduire l’utilisation de tokens et sont compatibles avec le standard ouvert agentskills.io.¹¹

Tous les skills se trouvent dans ~/.hermes/skills/ — le répertoire principal et la source de référence. Lors d’une nouvelle installation, les skills fournis sont copiés depuis le dépôt. Les skills installés depuis le hub et ceux créés par l’agent y sont également placé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 d’un 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. Cela est particulièrement utile pour les skills de secours — des alternatives gratuites ou locales qui ne doivent apparaître que lorsqu’un outil premium n’est pas disponible :¹¹

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 via l’outil skill_manage. Il s’agit de la mémoire procédurale de l’agent — lorsqu’il élucide un flux de travail non trivial, il enregistre l’approche sous forme de skill pour la réutiliser ultérieurement.¹¹

Lorsque l’agent crée des skills :¹¹ - Après avoir mené à bien une tâche complexe (plus de 5 appels d’outils) - Lorsqu’il a rencontré des erreurs ou des impasses et trouvé la procédure qui fonctionne - Lorsque l’utilisateur a corrigé son approche - Lorsqu’il a découvert un flux de travail non trivial

Actions :¹¹

Hub de skills

Parcourez, recherchez, installez et gérez des skills depuis des 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 :¹¹

Dépôts 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 le hub sont soumis à un scanner de sécurité qui vérifie l’exfiltration de données, l’injection de prompts, les commandes destructrices, les signaux liés à la chaîne d’approvisionnement et d’autres menaces.¹¹

Niveaux de confiance :¹¹

--force peut ignorer les blocages de politique non dangereux pour les skills communautaires. Il n’ignore pas un verdict d’analyse dangerous.¹¹

Répertoires de skills externes

Vous pouvez indiquer à Hermes des répertoires de skills supplémentaires, analysés en même temps que le répertoire local :¹¹

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

Les chemins prennent en charge l’expansion de ~ et la substitution de variables d’environnement ${VAR}. Les répertoires externes sont en lecture seule — lorsque l’agent crée ou modifie un skill, il écrit toujours dans ~/.hermes/skills/. La priorité locale l’emporte si un nom de skill existe aux deux emplacements.¹¹

Mémoire persistante

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

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

Modèle de l’instantané figé : l’injection dans le prompt système est capturée une fois au démarrage de la session et ne change jamais en cours de session. C’est intentionnel — cela préserve le cache de préfixe de LLM pour les performances. Les modifications effectuées pendant une session sont immédiatement enregistrées sur le disque, mais n’apparaissent pas dans le prompt système avant la session suivante.¹²

Éléments à enregistrer

Enregistrez ces éléments (l’agent le fait de façon proactive) :¹² - Préférences utilisateur : « I prefer TypeScript over JavaScript » → user - Faits sur l’environnement : « This server runs Debian 12 with PostgreSQL 16 » → memory - Corrections : « Don’t use sudo for Docker commands, user is in docker group » → memory - Conventions : « Project uses tabs, 120-char line width, Google-style docstrings » → memory - Travail terminé : « Migrated database from MySQL to PostgreSQL on 2026-01-15 » → memory

Ignorez ces éléments :¹² - Informations triviales ou évidentes - Faits faciles à redécouvrir - Exports de données brutes (trop volumineux pour la mémoire) - Éléments éphémères propres à une session - Informations déjà présentes dans les fichiers de contexte

Recherche de 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 plein texte FTS5. Les requêtes renvoient les conversations passées pertinentes avec une synthèse par Gemini Flash.¹²

Fournisseurs de mémoire externes

Pour une mémoire persistante plus approfondie au-delà de MEMORY.md et USER.md, Hermes est fourni avec huit plugins de fournisseurs de mémoire externes : Honcho, OpenViking, Mem0, Hindsight, Holographic, RetainDB, ByteRover et Supermemory.¹²

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

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 est toujours active.⁶

Reprise automatique des sessions (v0.13.0+)

La v0.13.0 permet de survivre aux interruptions en cours d’exécution de l’agent. Après un redémarrage, le gateway reprend automatiquement les sessions interrompues ; les redémarrages via /update préservent l’état des sessions pendant la mise à niveau ; les rechargements de fichiers source pendant le développement maintiennent la session active au lieu d’en imposer une nouvelle.¹⁸ En pratique, les longues tâches du gateway et les tâches pilotées par cron ne réinitialisent plus leur fenêtre de contexte lorsque le processus redémarre.

Checkpoints v2 (v0.13.0+)

La persistance d’état est réécrite dans la v0.13.0 sous la forme d’une architecture à magasin unique, avec un véritable élagage, des garde-fous sur le disque et aucun dépôt fantôme orphelin.¹⁸ L’ancien système de checkpoints accumulait l’état sur le disque dans les profiles exécutés sur de longues durées ; le magasin v2 impose un plafond strict au stockage local des checkpoints et supprime la gestion dupliquée à l’origine de cette croissance. Aucun changement de configuration côté utilisateur n’est nécessaire ; la prochaine écriture de 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 dans le prompt système et remplace l’identité par défaut codée en dur.¹³

Hermes initialise automatiquement un SOUL.md par défaut dans ~/.hermes/SOUL.md (ou $HERMES_HOME/SOUL.md pour les profiles personnalisés). Les fichiers utilisateur existants ne sont jamais écrasés. Hermes ne charge SOUL.md que 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.¹³

Ce qui appartient à SOUL.md

Utilisez-le pour des directives durables sur la voix et la personnalité :¹³ - ton - style de communication - niveau 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 :¹³ - instructions de projet ponctuelles - chemins de fichiers - conventions de dépôt - détails de workflow temporaires

Ces éléments appartiennent à AGENTS.md, pas à SOUL.md.

SOUL.md et AGENTS.md

C’est 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, comportement au niveau de la personnalité.

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

Une règle utile : si cela doit vous suivre partout, cela appartient à SOUL.md. Si cela appartient à un projet, cela appartient à AGENTS.md.¹³

Personnalités intégrées

Hermes est fourni avec 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.

Basculez ensuite avec /personality codereviewer.

SOUL.md et /personality

SOUL.md définit la voix de référence. /personality est une surcouche au niveau de la session.¹³ Conservez un SOUL.md pragmatique par défaut, puis utilisez /personality teacher pour une conversation de tutorat ou /personality creative pour un 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é à un ensemble d’outils sélectionnés via leurs identifiants Portal existants — aucune clé API supplémentaire à gérer.³⁰ 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 à plus que l’inférence de modèles.

Contenu du gateway

Fonctionnement

Le gateway est activé individuellement pour chaque outil via 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 passent par Portal. Sinon, votre clé API directe (si elle existe) est utilisée.

# 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

Priorité à l’exécution : lorsque le gateway est disponible et qu’un outil a use_gateway: true, Hermes privilégie le gateway même si vous avez également configuré une clé API directe. C’est important pour la facturation — les appels via le gateway sont déduits de votre abonnement Portal, et non du solde de votre clé API directe.

Activer le 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 Portal OAuth que vous possédez déjà dans hermes auth — il n’existe pas d’étape de connexion distincte. Depuis v0.19.0, vous pouvez également gérer l’abonnement lui-même depuis une session : /subscription affiche votre formule et votre quota restant, prévisualise exactement le coût d’une mise à niveau ou la date d’effet d’un rétrogradage, puis applique le changement avec des bannières de modification planifiée et une option d’annulation ; /topup ajoute du crédit. L’application de bureau propose un onglet de paramètres de facturation correspondant.²⁵

Tarification et accès

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

Avis de dépréciation

• La variable d’environnement HERMES_ENABLE_NOUS_MANAGED_TOOLS est supprimée dans v0.10.0. Les outils gérés sont désormais activés via le champ de configuration use_gateway par outil et dépendent de l’état de votre abonnement Portal.³⁰

Cadre : ce que cette version n’est pas

Le CLI Hermes Agent n’est pas soumis à un abonnement. Le projet reste sous licence MIT, toutes les fonctionnalités principales (CLI, skills, mémoire, gateway de messagerie, cron, MCP, tableau de bord local, BYOK pour chaque fournisseur) fonctionnent de bout en bout sans payer personne. La v0.10.0 ajoute une solution pratique pour les utilisateurs qui paient déjà pour Nous Portal — elle ne retire rien au parcours gratuit.

Gateway de messagerie

Hermes peut fonctionner comme un processus gateway de longue durée qui connecte 28 plateformes de messagerie depuis un seul processus gateway : Telegram, Discord, Slack, WhatsApp, Signal, SMS, Email, Home Assistant, Mattermost, Matrix, DingTalk, Feishu/Lark, WeCom, Weixin (WeChat), BlueBubbles (iMessage), QQBot, Microsoft Teams, Tencent Yuanbao, Google Chat, LINE, SimpleX Chat et un adaptateur Webhook générique.^329171819 La v0.9.0 a ajouté iMessage via BlueBubbles (enregistrement automatique des Webhook, assistant de configuration, résilience aux plantages) et la prise en charge native de WeChat via iLink Bot API avec le mode callback WeCom pour les 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 extensibles ; IRC et Microsoft Teams ont également été migrés vers le nouveau modèle d’adaptateur avec des 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 la pile Microsoft Teams de bout en bout avec l’authentification Graph, un écouteur Webhook, le runtime du pipeline et la livraison sortante.¹⁹ 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’exigence d’un processus bridge), les groupes SimpleX et les pièces jointes natives, ainsi que Raft comme plugin de plateforme intégré.²¹

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 bot, mappages de canaux, listes d’autorisation.⁶

Flux des messages

Extrait de 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

Chaque plateforme de messagerie passe par la même boucle de conversation AIAgent que le CLI. C’est pourquoi les commandes slash fonctionnent de manière identique dans les deux cas et pourquoi une tâche cron planifiée dans Telegram peut livrer son résultat dans Discord — la différence entre les plateformes ne se situe qu’à la périphérie.³

La v0.19.0 ajoute le routage des messages par profile et une livraison durable. Un seul gateway multiplexé partageant un token de bot peut acheminer des guildes, canaux ou threads spécifiques vers différents profiles — chacun avec une configuration, des skills, une mémoire et des secrets entièrement isolés — grâce à un override GATEWAY_MULTIPLEX_PROFILES, et une vague de renforcement empêche désormais qu’un profile mal configuré fasse tomber tout le gateway. Sous le capot, l’index de routage a été déplacé dans state.db (sessions.json est maintenant un miroir hérité facultatif), et les réponses finales sont enregistrées dans un registre durable d’obligations de livraison autour de l’envoi par plateforme — une réponse terminée qui rencontre un plantage du gateway est livrée de nouveau au prochain démarrage au lieu d’être silencieusement perdue.²⁵

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é.⁶

Tâches planifiées (Cron)

Hermes dispose d’un système cron de première classe dans lequel les tâches sont des tâches d’agent, et non des commandes shell. Chaque tâche planifiée s’exécute via un nouveau AIAgent avec le prompt configuré, des skills facultatifs attachés, et livre les résultats sur n’importe quelle plateforme :³⁶

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

Ou créez-en une de manière conversationnelle dans une discussion de messagerie :

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

L’agent configurera la tâche cron via ses outils. Les tâches persistent dans JSON et survivent aux redémarrages.³

Intégration de MCP

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

En tant que client — connectez Hermes à des serveurs MCP externes afin d’étendre sa surface d’outils :

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

Ou manuellement dans config.yaml :¹⁴

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

Depuis v0.19.0, les outils MCP sont exposés au modèle selon la convention de nommage mcp__server__tool — chaque nom d’outil porte le nom de son serveur, afin que deux serveurs exposant le même outil n’entrent plus en conflit — et les notifications de journal des serveurs MCP sont affichées dans agent.log.²⁵

En tant que serveur — exposez les conversations Hermes à d’autres agents :

hermes mcp serve
hermes mcp serve -v    # Verbose

Compression du contexte

Hermes compresse automatiquement les longues conversations afin de rester dans la fenêtre de contexte de votre modèle. Le résumeur de compression est un appel LLM distinct — vous pouvez le diriger vers n’importe quel provider ou endpoint.⁴

compression:
  enabled: true
  threshold: 0.50                           # Compress at this % of context limit
  target_ratio: 0.20                        # Fraction to preserve as recent tail
  protect_last_n: 20                        # Min recent messages to keep uncompressed
  summary_model: "google/gemini-3-flash-preview"
  summary_provider: "auto"                  # "auto", "openrouter", "nous", "codex", "main", etc.
  summary_base_url: null                    # Custom OpenAI-compatible endpoint

Options de provider :⁴

summary_model doit prendre en charge une longueur de contexte au moins aussi grande que celle de votre modèle principal, car il reçoit toute la section centrale de la conversation à compresser.⁴

Avertissements de pression sur le budget

Lorsque l’agent travaille sur une tâche complexe avec de nombreux appels d’outils, il peut épuiser son budget d’itérations (500 tours par défaut depuis 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 du flux

La connexion de streaming LLM comporte deux couches de délai d’expiration qui s’ajustent automatiquement pour les providers locaux (localhost, IP de LAN) :⁴

Le délai de lecture du socket est porté à 30 minutes pour les endpoints locaux, car les LLMs locaux peuvent mettre plusieurs minutes à effectuer le préremplissage sur de grands contextes avant de produire le premier token.⁴

Tableau de bord web local (v0.9.0+)

Un tableau de bord accessible dans le navigateur pour gérer votre Hermes Agent localement. Configurez les paramètres, surveillez les sessions, parcourez les skills et gérez votre gateway sans toucher aux fichiers de configuration ni au terminal.¹⁶ Lancez-le avec hermes dashboard. C’est le parcours d’intégration le plus simple pour les nouveaux utilisateurs qui préfèrent une GUI.

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 de recevoir des notifications en temps réel lorsqu’ils correspondent.¹⁶ Surveillez les erreurs, attendez des événements spécifiques (« listening on port ») ou observez les journaux de build — sans aucune interrogation périodique. Combiné à notify_on_complete de v0.8.0 (qui notifie 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 interchangeable (v0.9.0+)

La gestion du contexte est désormais un emplacement interchangeable via hermes plugins. Intégrez des context engines personnalisés qui contrôlent ce que voit l’agent à chaque tour — filtrage, résumé ou injection de contexte propre à un domaine.¹⁶ Cela découple la stratégie de contexte de la boucle principale de l’agent et permet une personnalisation du contexte par projet ou par 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 restaure depuis une archive de sauvegarde.¹⁶ Utilisez cette fonction pour migrer entre des machines, créer des instantanés avant des changements majeurs ou partager avec vos collègues une configuration validée.

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

Hermes s’exécute nativement sur Android via Termux. Les chemins d’installation sont adaptés, la TUI est optimisée pour les écrans mobiles, le backend vocal est pris en charge et la commande /image fonctionne 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 réglage par défaut en faveur de l’utilisateur.¹⁸ La v0.14.0 poursuit avec 12 corrections P0 et 50 corrections P1 supplémentaires, notamment le renforcement contre le brute force sudo / sudo-stdin, des correctifs de contournement de 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 de skills-hub et l’analyse des avis liés à la chaîne d’approvisionnement lors de l’installation.¹⁹

Si vous maintenez un déploiement Hermes, considérez les v0.13.0 et v0.14.0 comme des mises à niveau importantes pour la sécurité, et non comme de simples ajouts de fonctionnalités. La v0.13.0 corrige le contournement Discord entre guilds et deux fenêtres TOCTOU ; la v0.14.0 ajoute un nouveau renforcement concernant la gestion de sudo, la réinjection des erreurs d’outils, les APIs des plugins, le SSRF de skills-hub et les avis sur les dépendances.

Architecture pour les praticiens

Cette section s’adresse aux personnes qui souhaitent comprendre ce qui se passe en coulisses afin de pouvoir déboguer, étendre ou évaluer les performances. Il s’agit d’une synthèse de la documentation d’architecture en amont.³

Points d’entrée → AIAgent

Dans Hermes, chaque point d’entrée appelle en définitive 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 en amont.³

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

Les trois modes API

Hermes abstrait les différences entre providers en trois modes API, sélectionnés automatiquement à l’exécution :³

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

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

User input → HermesCLI.process_input()
  → AIAgent.run_conversation()
    → 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 en amont.³

Ordre d’assemblage du prompt

La pile de prompts comprend :¹³

1. SOUL.md (identité de l’agent — ou solution de repli intégrée s’il est indisponible)
2. Des consignes de comportement tenant compte des tools
3. Le contexte de mémoire/utilisateur (MEMORY.md, USER.md)
4. Les consignes relatives aux skills
5. Les fichiers de contexte (AGENTS.md, .cursorrules)
6. L’horodatage
7. Des indications de mise en forme propres à la plateforme
8. Des superpositions facultatives de system prompt, telles que /personality

SOUL.md constitue la base — tout le reste s’appuie dessus.¹³

Stockage des sessions

Stockage des sessions basé sur SQLite avec recherche en texte intégral FTS5. Les sessions disposent d’un suivi de filiation (parent/enfant lors des compressions), d’une isolation par plateforme et d’écritures atomiques avec gestion de la contention.³

Système de plugins

Trois sources de découverte : ~/.hermes/plugins/ (utilisateur), .hermes/plugins/ (projet) et points d’entrée pip. Les plugins enregistrent des tools, des hooks et des commandes CLI via un contexte API. Les providers de mémoire constituent un type de plugin spécialisé sous plugins/memory/.³

hermes plugins                       # Interactive enable/disable UI
hermes plugins install <repo>        # Install from Git URL or owner/repo
hermes plugins enable <name>
hermes plugins disable <name>
hermes plugins list

Principes de conception

Extrait de la page d’architecture en amont :³

Migration depuis OpenClaw

Hermes Agent succède à OpenClaw. Si vous migrez 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 depuis ~/.openclaw (et détecte automatiquement les anciens dossiers ~/.clawdbot et ~/.moldbot) et écrit dans ~/.hermes.⁶

Importé directement (plus de 30 catégories) : SOUL.md, MEMORY.md, USER.md, AGENTS.md, skills provenant de 4 répertoires sources, modèle par défaut, providers personnalisés, serveurs MCP, tokens et listes d’autorisation des plateformes de messagerie (Telegram, Discord, Slack, WhatsApp, Signal, Matrix, Mattermost), paramètres par défaut de l’agent (effort de raisonnement, compression, délai humain, fuseau horaire, sandbox), politiques de réinitialisation des sessions, règles d’approbation, configuration TTS, paramètres du navigateur, paramètres des tools, délai d’expiration exec, liste d’autorisation des commandes, configuration du gateway et clés API issues de 3 sources.⁶

Archivé pour examen manuel : tâches cron, plugins, hooks/webhooks, backend de mémoire (QMD), configuration du registre de skills, UI/identité, journalisation, configuration multi-agent, liaisons 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.⁶

Dépannage

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

La première erreur rencontrée après toute nouvelle installation : Hermes n’a pas encore de provider résolu. Cela signifie exactement ce qui est indiqué — aucune des trois voies d’authentification n’a produit de provider utilisable. Exécutez :

hermes model

Le sélecteur interactif vous guide parmi tous les providers pris en charge, y compris les flux de 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 provider était déjà configuré, hermes doctor indique les identifiants que Hermes détecte réellement ; 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 profil shell), un identifiant OAuth expiré dans ~/.hermes/auth.json, ou un endpoint personnalisé dans config.yaml qui a perdu son base_url. Les voies d’authentification sont détaillées dans Authentication & Providers.²⁷

« API key not set »

Exécutez hermes model pour configurer votre provider 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 de contexte depuis 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 de s’exécuter

Votre serveur n’a pas les appels d’outils activés, ou le modèle ne les prend pas en charge via l’implémentation du serveur.²

Les réponses sont coupées au milieu d’une phrase

Deux causes possibles :²

1. Limite de sortie basse (max_tokens) sur le serveur — SGLang utilise par défaut 128 tokens par réponse. 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 — localhost dans WSL2 désigne la VM Linux, et non l’hôte Windows. Deux options :²

Réseau en miroir (Windows 11 22H2+) : modifiez %USERPROFILE%\.wslconfig :

[wsl2]
networkingMode=mirrored

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

Solution de repli avec l’IP de l’hôte (anciennes versions de Windows) : récupérez l’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 se lier à 0.0.0.0, et non à 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.²

Où se trouve tout ?

hermes status et hermes dump vous seront utiles ici. hermes logs list affiche tous les fichiers de 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 de Nous Research qui fonctionne avec tout provider compatible OpenAI — Nous Portal, OpenRouter, Anthropic, GitHub Copilot, z.ai, Kimi, MiniMax, DeepSeek, Hugging Face, Google ou votre propre endpoint auto-hébergé.¹² Hermes propose é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 :²

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

L’option 2 est préférable si vous utilisez déjà Claude Code sur la même machine — elle préserve le caractère actualisable des identifiants Claude actualisables.

Comment changer de provider sans perdre ma conversation ?

Utilisez /model provider:model dans une session. L’historique de conversation, la mémoire et les skills sont tous 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

Vous rencontrez le repli vers le modèle auxiliaire. La vision, la synthèse web, la compression et d’autres tâches secondaires utilisent un LLM auxiliaire distinct — par défaut Gemini Flash via la détection automatique (OpenRouter → Nous → Codex). Si aucun de ces éléments n’est configuré et que seul Anthropic est configuré, ces fonctionnalités se dégradent silencieusement.⁴

Correctif : ajoutez soit une OPENROUTER_API_KEY pour les tâches auxiliaires, soit reconfigurez les emplacements auxiliaires pour utiliser votre provider principal. Notez que la compression de contexte réside dans son propre bloc compression: de premier niveau et utilise summary_provider, et non auxiliary.compression.provider — l’emplacement auxiliary.compression n’expose qu’un timeout. Correctif complet :

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

compression:
  summary_provider: "main"

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

SOUL.md correspond à l’identité de votre agent — ton, style et préférences de communication. Il se trouve dans ~/.hermes/SOUL.md et vous suit partout. AGENTS.md est spécifique à un projet — architecture, conventions, commandes, chemins — et se trouve dans le répertoire de votre projet.¹³ S’il doit vous suivre partout, utilisez SOUL.md. S’il appartient à un projet, utilisez AGENTS.md.

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

Les profiles. Chaque profile possède son propre HERMES_HOME, sa configuration, sa mémoire, ses sessions et son 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, via la voie des endpoints personnalisés. Hermes fonctionne avec tout serveur compatible OpenAI : Ollama, vLLM, SGLang, llama.cpp/llama-server, LM Studio, LocalAI, Jan ou le vôtre.² Consultez Custom & Self-Hosted Endpoints pour la configuration propre à chaque serveur.

Pourquoi ma bannière de démarrage affiche-t-elle moins d’outils que le guide indique que Hermes en possède ?

Le guide cite 47 outils / 20 toolsets issus du registre d’architecture amont — c’est le nombre total d’outils dont Hermes fournit le code source dans tous les toolsets. Votre installation en cours affiche un nombre inférieur dans la bannière (l’installation de référence utilisée pour ce guide indique 28 outils), car Hermes n’active au démarrage que l’ensemble de toolsets par défaut. De nombreux toolsets sont optionnels : les adaptateurs de gateway de messagerie, l’automatisation du navigateur, les piles de scraping 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 réellement chargé ». Utilisez hermes tools --list pour voir quels toolsets sont actifs et lesquels sont disponibles mais désactivés. Activez ou désactivez des toolsets individuels à l’exécution avec /tools enable <name> et /tools disable <name> (la désactivation entraîne une réinitialisation de session afin que l’agent reconstruise son manifeste d’outils avec la nouvelle configuration).

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

Configurez un bloc fallback_model dans config.yaml :²

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

Lorsque le provider principal échoue (limite de débit, erreur serveur, échec d’authentification), Hermes bascule vers le modèle de repli en pleine session sans perdre l’historique de conversation. Cela ne se produit qu’une fois au maximum par session.

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

Oui — c’est la partie « auto-améliorative » de Hermes Agent. L’agent peut créer, mettre à jour et supprimer des skills via l’outil skill_manage. Lorsqu’il détermine un workflow non trivial, il enregistre l’approche comme skill afin de pouvoir la réutiliser ultérieurement.¹¹ L’agent crée des skills après des tâches complexes (5+ appels d’outils), lorsqu’il rencontre des erreurs et trouve la voie fonctionnelle, lorsque vous corrigez son approche ou lorsqu’il découvre un workflow non trivial.

Existe-t-il une intégration IDE ?

Oui — Hermes peut s’exécuter comme serveur ACP (Agent Client Protocol) pour VS Code, Zed et JetBrains :⁶

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

Journal des modifications

Références