Hermes Agent : ce que c’est, comment l’installer et le configurer

Claude Code, Codex, Cursor, OpenClaw : chacun de ces agents IA a son propre rôle. Si vous avez besoin d’un agent qui tourne sur votre serveur, se souvient de vous d’une session à l’autre et vous répond sur Telegram pendant que vous êtes dans un taxi, Hermes Agent est adapté à ce rôle.

Hermes Agent est un projet ouvert de Nous Research, et son installation est bien plus simple que beaucoup ne le pensent. Voici ce que vous allez découvrir : ce que c’est, combien cela coûte, comment l’installer sur Windows, macOS ou Linux, et comment y connecter un modèle et un bot Telegram. Tout repose sur la documentation officielle.

Agent IA Hermes : fonctionnement, outils et mémoire#

Hermes appartient à la même catégorie que Claude Code ou Codex : c’est un agent IA qui ne se contente pas de rédiger des réponses ; il ouvre des fichiers, exécute des commandes dans le terminal et utilise un navigateur. La différence tient à sa conception : Claude Code est lié aux modèles d’Anthropic, tandis que Hermes fonctionne avec n’importe quel fournisseur de modèles, de Claude et GPT aux modèles locaux exécutés sur votre matériel.

Le projet est récent : son dépôt GitHub a été créé le 22 juillet 2025. Pourtant, au 22 août 2026, il compte plus de 234 000 étoiles et 47 000 forks, ce qui en fait l’un des projets ouverts de cette catégorie connaissant la croissance la plus rapide. Le code est entièrement ouvert sous licence MIT : vous pouvez le lire, le modifier et l’utiliser dans vos produits sans redevance.

Deux mécanismes précis sous-tendent cette « amélioration continue » : les skills et la mémoire. Les skills sont des procédures que l’agent consigne après des tâches complexes et applique la fois suivante. La mémoire est un fichier contenant des informations sur vous et votre environnement, chargé dans chaque nouvelle conversation. Ces deux mécanismes sont présentés plus bas dans une section distincte.

En quoi Hermes Agent diffère-t-il de Claude Code et Codex ?#

Les principales différences sont résumées dans ce tableau :

Le tableau fait ressortir l’essentiel. Claude Code convient aux tâches qui nécessitent le modèle le plus performant et se déroulent dans un dépôt : Anthropic conserve ici la meilleure combinaison de modèle et d’outils. Hermes s’adresse aux situations où vous avez besoin d’un agent « toujours disponible » : il tourne sur un serveur, effectue une tâche chaque matin selon un calendrier, vous répond sur Telegram et se souvient de la conversation de la veille.

Si vous comparez des outils de base, consultez les guides distincts sur l’installation de Claude Code, Codex d’OpenAI et le paysage des outils de programmation par IA en 2026.

Combien coûte Hermes Agent en 2026 ?#

L’option la plus simple est Nous Portal, l’abonnement natif proposé par les développeurs de Hermes. Il donne accès à plus de trois cents modèles et comprend aussi des services prêts à l’emploi : recherche sur le Web, génération d’images, synthèse vocale et navigateur cloud. Au 22 août 2026, les forfaits sont les suivants :

La deuxième option, souvent négligée, consiste à ne pas souscrire du tout de nouvel abonnement. Hermes peut se connecter par OAuth, c’est-à-dire via un compte que vous possédez déjà. Les abonnements ChatGPT et Codex, Claude Max, SuperGrok de xAI, Qwen, MiniMax et GitHub Copilot sont pris en charge. Choisissez un fournisseur lors de la configuration, confirmez la connexion dans votre navigateur, et vous continuerez à payer exactement comme avant.

La troisième option consiste à utiliser vos propres clés API. Anthropic, OpenAI, Google, DeepSeek, Z.AI, Kimi, Alibaba et une douzaine d’autres fournisseurs : saisissez une clé, et l’utilisation sera facturée directement sur leur compte.

La quatrième option ne coûte rien, mais nécessite du matériel : un modèle local via Ollama ou LM Studio. Cela convient si vous avez un ordinateur puissant et ne souhaitez pas envoyer vos données à l’extérieur. Une condition s’applique : le modèle doit avoir une fenêtre de contexte d’au moins 64 000 tokens, sinon Hermes refusera de démarrer avec ce modèle ; l’agent a besoin d’une mémoire de travail suffisante pour les longues tâches.

Les modalités de paiement des services étrangers ne sont pas abordées ici : c’est un sujet distinct, avec ses propres règles, traité dans ce guide qui prend Claude Code comme exemple.

Comment installer Hermes Agent sur Windows#

Si vous n’êtes pas habitué au terminal, commencez par l’installateur. Le site hermes-agent.nousresearch.com propose des boutons de téléchargement pour macOS 12+, Windows 10/11 et Linux. Le fichier téléchargé installe les deux applications à la fois : la ligne de commande hermes et Hermes Desktop, une fenêtre classique avec un chat, des fichiers et des paramètres.

Si vous avez l’habitude des commandes, installez Hermes via PowerShell :

1. Ouvrir PowerShell

   Appuyez sur Win, saisissez PowerShell et ouvrez-le. Les droits d’administrateur ne sont pas nécessaires.

2. Exécuter l’installateur

   iex (irm https://hermes-agent.nousresearch.com/install.ps1)
   

   Le script télécharge tout ce dont il a besoin : Python 3.11, Node.js 22, le gestionnaire de paquets uv, ripgrep et ffmpeg. Si Git n’est pas installé, il installe sa propre version isolée de MinGit, stockée à part et sans incidence sur les programmes système.

3. Redémarrer le terminal et vérifier

   hermes doctor
   

   La commande indique ce qui est installé, ce qui manque et comment résoudre le problème. Si vous voyez des coches vertes, tout est installé.

Avec cette méthode d’installation, les fichiers sont stockés dans %LOCALAPPDATA%\hermes. Si vous utilisez WSL2, la commande Linux de la section suivante fonctionne aussi dans cet environnement ; choisissez la méthode qui vous convient le mieux.

Comment installer Hermes Agent sur macOS et Linux#

Hermes s’installe avec une seule commande, sur un ordinateur portable ou un serveur. Voici toutes les étapes :

1. Vérifier que Git est installé

   git --version
   

   Si la commande renvoie un numéro de version, continuez. Sous Linux, vérifiez aussi la présence de curl et de xz-utils : sous Debian et Ubuntu, installez-les avec sudo apt install curl xz-utils.

2. Exécuter l’installateur

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

   Le script clone le dépôt dans ~/.hermes/hermes-agent, crée un environnement virtuel et installe la commande hermes dans ~/.local/bin. Pour un serveur sans interface graphique ni automatisation du navigateur, une option légère est disponible : ajoutez bash -s -- --skip-browser à la fin.

3. Recharger le shell et démarrer

   source ~/.zshrc   # on macOS; on Linux, more often: source ~/.bashrc
   hermes
   

Lors d’une installation en tant que root, les fichiers sont placés dans les chemins système /usr/local/lib/hermes-agent et /usr/local/bin/hermes, ce qui est pratique pour un serveur utilisé par plusieurs comptes. Les paramètres, les clés et la mémoire restent dans le dossier personnel ~/.hermes de chaque utilisateur.

Une remarque sur Hermes Desktop sous Linux : pour compiler l’application sous Debian et Ubuntu, vous avez besoin des compilateurs inclus dans le paquet build-essential (sudo apt install build-essential). Et si vous avez installé Hermes avec la commande, aucun installateur distinct n’est nécessaire : exécutez hermes desktop, et l’application démarrera avec vos paramètres, sessions et skills existants.

Comment connecter un modèle à Hermes Agent#

Le modèle est le moteur de Hermes : l’agent ne réfléchit pas de lui-même, il contacte le modèle que vous choisissez. La première étape après l’installation consiste donc à choisir le service auquel il se connectera :

hermes model

L’assistant de configuration vous demandera de choisir un fournisseur, une méthode de connexion et un modèle. Les possibilités sont nombreuses ; voici les principales :

Si vous choisissez Nous Portal, une seule commande s’occupe de tout :

hermes setup --portal

Elle ouvre une page de connexion dans votre navigateur. Après confirmation, elle définit Nous comme fournisseur et active Tool Gateway : recherche sur le Web, génération d’images et synthèse vocale, sans clés distinctes pour chaque service.

Hermes stocke séparément les clés et les paramètres ; il est important de le savoir dès le départ. Les secrets, c’est-à-dire les clés API et les tokens, sont stockés dans ~/.hermes/.env. Les paramètres courants se trouvent dans ~/.hermes/config.yaml. Vous n’avez pas besoin de modifier ces fichiers à la main : hermes config set place automatiquement chaque valeur dans le bon fichier :

Trouver des guides sur les outils dans la documentation Ailoot

L’assistant de configuration complet est hermes setup. Il propose trois modes : une configuration rapide via Nous Portal, une configuration complète où vous choisissez vous-même chaque fournisseur et chaque outil, et Blank Slate, une installation vierge où tout est désactivé sauf l’essentiel, afin que vous n’activiez que ce dont vous avez besoin.

Comment vérifier que Hermes Agent fonctionne#

Après avoir choisi un modèle, démarrez une conversation :

hermes          # classic interface
hermes --tui    # modern interface, with mouse support and pop-up windows

La bannière de bienvenue affiche le modèle sélectionné, les outils activés et les skills. Ensuite, ne demandez pas « Bonjour, qui es-tu ? » : donnez-lui une tâche avec un résultat visible, comme « montre-moi les cinq plus grands dossiers du disque » ou « regarde le dossier actuel et dis-moi quel fichier est le fichier principal du projet ». Si l’agent exécute une commande dans le terminal et renvoie une réponse pertinente, la configuration de base fonctionne.

Dernière vérification : les sessions. Quittez la conversation, puis revenez :

hermes --continue   # or shorter: hermes -c

Vous devriez retrouver la même conversation. Cela vérifie que les données de session sont enregistrées sur le disque ; le bot et les tâches planifiées en dépendront par la suite.

En cas de problème, procédez dans cet ordre : hermes doctor (diagnostic général), hermes model (vérifier à nouveau le modèle et la connexion), hermes setup (reconstruire la configuration), hermes sessions list et hermes --continue (vérifier les sessions), hermes gateway status (état du gateway). En quelques minutes, cette séquence peut vous faire passer de « tout est cassé » à une situation claire.

Que sont les skills et la mémoire dans Hermes Agent ?#

Un skill Hermes est un fichier SKILL.md comprenant un nom, une description et une procédure étape par étape : par exemple, comment assembler un document, ouvrir une pull request ou préparer un mailing. L’agent lit les descriptions courtes de tous les skills, puis ne charge le texte complet que lorsque la tâche correspond ; ainsi, cent skills installés n’alourdissent pas chaque demande. La norme est ouverte : agentskills.io, et les mêmes fichiers fonctionnent dans d’autres agents.

Les skills se trouvent dans le dossier ~/.hermes/skills/. Ils y arrivent de trois façons : un ensemble de base est installé avec l’application, des skills prêts à l’emploi peuvent être ajoutés depuis le catalogue avec hermes skills install, et l’agent en rédige lui-même après des tâches complexes. Chaque skill devient automatiquement une commande slash : installez le skill gif-search, et /gif-search fonctionne dans n’importe quel chat. L’installation depuis le catalogue fait l’objet d’un contrôle de sécurité pour éviter que la procédure de quelqu’un d’autre n’introduise des commandes malveillantes.

La mémoire est encore plus simple. Elle consiste en deux fichiers dans ~/.hermes/memories/ : MEMORY.md, les notes de l’agent sur son environnement et ses conclusions, jusqu’à 2 200 caractères ; et USER.md, votre profil : comment vous répondre, ce que vous aimez et n’aimez pas, jusqu’à 1 375 caractères. Au début de chaque conversation, les deux fichiers sont ajoutés au prompt système, de sorte que l’agent sait déjà certaines choses sur vous. Les limites sont volontairement strictes : la mémoire ne s’étend pas sans fin, et l’agent décide quoi conserver et quoi écarter.

Ces deux éléments, les skills et la mémoire, constituent le Second Brain : un agent qui se souvient du contexte et accumule des procédures, et qui fonctionne nettement mieux chaque semaine qu’au jour de son installation. Pour savoir comment choisir ces skills et éviter que votre agent ne devienne un fourre-tout, consultez ce guide prenant Claude Code comme exemple : les principes sont les mêmes.

Comment connecter Hermes Agent à Telegram#

Telegram est le canal le plus populaire de Hermes, et son intégration est bien développée : texte, messages vocaux avec transcription, images et fichiers, et réponses dans les groupes. Voici la marche à suivre :

1. Créer un bot avec BotFather

   Ouvrez @BotFather dans Telegram, envoyez /newbot, choisissez un nom et un nom d’utilisateur unique se terminant par bot. Vous recevrez un token du type 123456789:ABCdef... : c’est la clé de votre bot, gardez-la donc comme un mot de passe. Si le token est divulgué, révoquez-le en envoyant /revoke au même BotFather.

2. Trouver votre identifiant utilisateur

   Trouvez votre identifiant numérique, par exemple 123456789.

3. Lancer l’assistant de configuration du gateway

   hermes gateway setup
   

   Sélectionnez Telegram, puis collez votre token et votre identifiant. L’assistant enregistrera les paramètres. Vous pouvez aussi le faire manuellement avec deux lignes dans ~/.hermes/.env : TELEGRAM_BOT_TOKEN=... et TELEGRAM_ALLOWED_USERS=123456789.

4. Démarrer le gateway

   hermes gateway
   

   Le bot sera en ligne après quelques secondes. Envoyez-lui un message et vérifiez sa réponse.

L’accès est fermé par défaut : le bot ne répond qu’aux identifiants figurant sur la liste. Vous pouvez donner un code d’association à une nouvelle personne ; il fonctionne pendant une heure, puis expire. La liste des utilisateurs en attente et approuvés est accessible avec hermes pairing list.

Il existe un piège concernant les discussions de groupe, souvent oublié. Par défaut, le mode de confidentialité des bots Telegram est activé : dans un groupe, un bot ne voit que les commandes et les réponses à ses propres messages. Pour qu’il puisse tout lire, désactivez ce mode via @BotFather (Bot Settings - Group Privacy) ou, plus simplement, faites du bot un administrateur du groupe.

Par défaut, le gateway interroge lui-même les serveurs de Telegram, ce qui convient à un ordinateur personnel ou à un serveur toujours allumé. Pour les plateformes cloud qui mettent la machine en veille en l’absence de trafic entrant, le mode webhook permet à Telegram d’envoyer les messages à votre adresse.

Que peut faire Hermes Agent après son installation ?#

Voici ce que vous pouvez activer, dans l’ordre :

1. Tâches planifiées. Le gateway intègre un planificateur : « Chaque matin à 8 heures, prépare un résumé des actualités sur les sujets qui m’intéressent et envoie-le-moi sur Telegram. » Définissez le calendrier avec une phrase ordinaire, et les résultats arriveront dans le même chat.
2. Hermes Desktop. La commande hermes desktop ouvre l’application pour macOS, Windows et Linux avec le même agent : réponses en continu, aperçus de fichiers à côté du chat, glisser-déposer de documents et compteur de contexte. Les sessions sont partagées : vous pouvez commencer dans le terminal et continuer dans la fenêtre.
3. Panneau Web. hermes dashboard ouvre dans le navigateur un panneau consacré aux canaux, à la mémoire, aux webhooks et aux profils. Pratique lorsque Hermes tourne sur un serveur.
4. Sous-agents. Vous pouvez déléguer une tâche importante à des agents auxiliaires isolés : chacun dispose de sa propre conversation et de son propre terminal, et ne consomme donc pas votre contexte.
5. Voix. Le mode vocal fonctionne dans le terminal, sur Telegram et Discord : vous pouvez dicter une tâche et recevoir une réponse orale.
6. Éditeur de code. Via le protocole ACP, Hermes se connecte à VS Code, Zed et JetBrains pour fonctionner comme agent directement dans l’éditeur.

Les outils peuvent être activés et désactivés un par un avec hermes tools, afin que l’agent ne garde pas tout à portée de main en permanence. Lorsque vous souhaitez passer sur une autre machine, hermes backup regroupe l’installation complète dans une archive, et hermes import la décompresse au nouvel emplacement.

À qui s’adresse Hermes Agent, et qui devrait attendre ?#

Installer Hermes a du sens lorsque vous savez ce que vous attendez d’un agent : trier des documents, construire un prototype, gérer de la correspondance ou préparer des résumés matinaux. L’outil en lui-même n’est pas l’essentiel ; ce sont les tâches que vous lui confiez. Un guide consacré aux tâches à donner à un agent IA traite de ce sujet.

Hermes peut ne pas vous convenir dans deux cas. Premièrement, si vous vous attendez à « vous inscrire et à ce que tout fonctionne » : Hermes doit être installé et connecté à un modèle. Cela ne prend qu’une commande, mais vous devez quand même ouvrir le terminal. Deuxièmement, si vous n’avez pas de modèle adapté et ne souhaitez pas vous renseigner sur les abonnements ou les clés API.

Tous les autres devraient commencer modestement : l’installer, choisir un modèle, avoir une conversation sans problème, puis ajouter un bot Telegram, et seulement ensuite les plannings et les sous-agents.

Quelles autres questions les gens posent-ils sur Hermes Agent ?#

Retrouvez d’autres ressources sur Ailoot.