Installer Hermes Agent : un premier agent prudent
Installer Hermes Agent pas à pas : précautions, script, hermes setup, modèle, backend isolé, passerelle, mises à jour. D'après le README lu le 24 octobre 2026.
En bref
- Installer Hermes Agent tient en quelques commandes : un script d'installation, puis
hermeset l'assistanthermes setup. Le vrai travail est ailleurs : choisir où l'agent exécute ses commandes, avec quel modèle et sur quel canal. - Trois précautions passent avant la première commande : un backend isolé, aucune donnée client, le canal de mises à jour stable.
- Ce tutoriel suit uniquement le README et les notes de version du dépôt NousResearch/hermes-agent, lus le 24 octobre 2026 (version stable : v0.22.5). Quand un détail n'y figure pas, nous renvoyons à la documentation du projet.
Hermes Agent est l'agent IA open source de Nous Research, publié sous licence MIT. Son fonctionnement, sa sécurité et son coût sont décrits dans notre guide Hermes Agent ; ce billet se limite à l'installation d'un premier agent, dans l'ordre où nous recommandons de la faire. Waimia n'a ni chronométré ni mesuré ces étapes : elles sont tirées de la documentation, et les passages marqués « Recommandation Waimia » sont des conseils, pas des résultats.
Gratuit, 45 minutes : un ou deux chantiers classés.
Réserver l'audit gratuit →Ce que couvre ce tutoriel
Un premier agent, pour une personne, sur une machine dédiée, avec une tâche sans conséquence. Pas un déploiement d'entreprise : ouvrir l'agent à une équipe, le brancher en écriture sur vos outils ou le faire répondre à des clients demande un cadre que ce billet ne pose pas. La question du multi-utilisateur est traitée dans le comparatif Hermes Agent ou OpenClaw.
Deux sources seulement : le README du dépôt GitHub NousResearch/hermes-agent et les notes de version de la v0.21.6 à la v0.22.5, lus le 24 octobre 2026. Nous ne recopions ni commande d'installation complète ni adresse de script. Le projet publie plusieurs versions par semaine, et une commande copiée depuis un billet vieillit vite : prenez-la toujours dans le README, à la source.
Trois précautions avant la première commande
Recommandations Waimia, à appliquer avant l'installation plutôt qu'après.
- Un backend isolé d'abord. Un agent exécute des commandes. Hermes Agent peut les lancer directement sur la machine qui l'héberge (backend local) ou dans un environnement séparé : un conteneur Docker, une autre machine jointe par SSH, un service distant. Pour un premier essai, installez-le sur une machine dédiée (un ancien portable, une machine virtuelle, un petit serveur) et choisissez un backend isolé. Jamais le backend local sur le poste qui contient vos fichiers de travail.
- Aucune donnée client. Le premier agent lit des documents publics ou des notes sans enjeu. L'agent garde une mémoire et l'historique de ses sessions : ce que vous lui montrez pendant l'essai y reste, jusqu'à sa suppression. Les données personnelles attendent que les flux soient écrits ; la checklist RGPD des agents IA donne les points à fixer.
- Une version stable, et des mises à jour testées. Restez sur le canal stable proposé depuis la v0.22.0, notez la version installée et lisez les notes avant chaque mise à jour. Le projet n'a pas atteint la v1.0 : une version peut encore déplacer une fonction vers un plugin, comme l'a fait la v0.22.5.
Deux réflexes complètent la liste : un compte dédié chez le fournisseur du modèle, avec un plafond de dépense, et un compte de messagerie dédié pour parler à l'agent. Le projet ne les impose pas ; ils limitent ce qu'un essai raté peut coûter.
Étape 1 : lancer le script d'installation
D'après le README lu le 24 octobre 2026, Hermes Agent s'installe de trois façons selon le système.
| Système | Méthode documentée | À savoir |
|---|---|---|
| Linux, macOS, Windows avec WSL2 | Script d'installation lancé avec curl | La voie la plus directe pour un serveur dédié sous Linux (avis Waimia) |
| Windows | Script PowerShell | L'application de bureau n'existe qu'en MSIX, pour Windows 11 22H2 ou plus récent |
| Android avec Termux | Dépôt APT | Un usage d'essai plutôt qu'un agent qui tourne en continu (avis Waimia) |
La v0.22.0 a aussi apporté des paquets de bureau signés, dont une version sur le Microsoft Store. La commande exacte, l'adresse du script et les prérequis éventuels : voir la documentation du projet, dans le README du dépôt. Recommandation Waimia : avant d'exécuter un script téléchargé, ouvrez-le et lisez-le, ou faites-le relire. C'est une habitude de base pour tout outil qui s'installe en une ligne.
Étape 2 : ouvrir hermes, puis hermes setup
Une fois l'installation faite, la commande hermes ouvre l'interface en terminal : c'est là que vous parlez à l'agent au début. La commande hermes setup lance l'assistant de configuration. Depuis la v0.22.0 (13 octobre 2026), un assistant de premier lancement guide aussi les débuts.
Les sources lues ne détaillent pas chaque question posée par l'assistant : voir la documentation du projet. Ce que nous recommandons de décider avant de l'ouvrir, pour répondre sans improviser :
- le modèle et le compte qui le paie (étape 3) ;
- le backend d'exécution (étape 4) ;
- le seul canal de messagerie que vous ouvrirez (étape 5), ou aucun : le terminal suffit à un premier essai.
Étape 3 : choisir le modèle avec hermes model
Hermes Agent n'impose pas de modèle. Le README cite quatre branchements : Nous Portal, OpenRouter, OpenAI, ou un point d'accès personnalisé. La commande hermes model change de modèle sans changer d'agent.
Depuis la v0.22.0, une autre voie existe : les modèles locaux, téléchargés et lancés en un clic grâce à llama.cpp. Le catalogue évalue chaque modèle selon votre carte graphique (GPU) et votre mémoire vive. Les notes citent Qwen3.8 27B, Qwen3.6 35B-A3B, DeepSeek V4 Flash, et tout modèle au format GGUF publié sur Hugging Face.
Recommandation Waimia pour un premier agent. Une API sous contrat, avec un plafond de dépense posé chez le fournisseur, pour juger l'agent sans dépendre de votre matériel. Un modèle local si vos données ne doivent pas sortir de vos machines, en sachant que sa qualité sur vos tâches reste à vérifier : nous n'avons pas de mesure à vous donner. Pour un modèle hébergé chez vous, voir aussi le billet IA auto-hébergée en PME. Le détail des nouveautés de la v0.22 est dans Hermes Agent v0.22 : ce qui change.
Étape 4 : isoler l'exécution avec un backend
Le backend est l'endroit où l'agent exécute ses commandes. C'est le réglage qui compte le plus pour la sécurité. Le README liste six backends intégrés, et d'autres arrivent par plugins.
| Backend | Où tournent les commandes | Pour un premier agent (avis Waimia) |
|---|---|---|
| Local | Sur la machine qui héberge l'agent | À éviter, sauf sur une machine vide et dédiée |
| Docker | Dans un conteneur, sur la même machine | Le choix que nous recommandons pour commencer |
| SSH | Sur une autre machine, jointe par SSH | Adapté si vous disposez d'une machine séparée sans données |
| Modal, Daytona, Vercel Sandbox | Chez un service d'exécution distant | Les données transitent chez ce tiers, sous ses conditions |
| bubblewrap, Singularity | Par plugins : bubblewrap sous Linux depuis la v0.22.4, Singularity passé en plugin en v0.22.5 | Pour les équipes qui connaissent déjà ces outils |
La v0.22.0 a rendu le bac à sable plus présent : l'image hermes-sandbox:desktop est utilisée par défaut, et avec Docker, SSH ou Singularity, l'écran du bot, l'utilisation de l'ordinateur et le navigateur tournent dans ce bac à sable plutôt que sur la machine hôte. La syntaxe pour choisir ou changer de backend : voir la documentation du projet.
Une vérification simple, recommandée par Waimia : une fois le backend choisi, demandez à l'agent de lister un dossier de la machine hôte. S'il y parvient, l'isolation n'est pas celle que vous croyez.
Étape 5 : ouvrir un seul canal de messagerie
La passerelle (gateway) relie l'agent à Telegram, Discord, Slack, WhatsApp, Signal et à la ligne de commande. Elle permet de lui écrire depuis votre téléphone et de recevoir le résultat des tâches planifiées.
Le README cite deux protections à garder actives : l'appairage par message privé, qui filtre qui peut parler à l'agent, et l'approbation des commandes, qui demande votre accord avant d'exécuter. Les étapes de connexion propres à chaque messagerie : voir la documentation du projet.
Recommandation Waimia : un seul canal pour commencer, un compte dédié, et personne d'autre que vous dans la conversation. Chaque message lu par l'agent peut contenir des instructions cachées (on parle d'injection de consignes) ; moins il y a d'expéditeurs, moins il y a de portes d'entrée. La même logique, appliquée à l'autre moteur ouvert, est détaillée dans sécuriser OpenClaw en 12 contrôles.
Étape 6 : confier une première tâche sans enjeu
Le premier agent doit pouvoir se tromper sans conséquence. Trois exemples de tâches à faible risque, proposés par Waimia :
- résumer chaque lundi une page publique que vous suivez (un texte réglementaire, une liste d'appels d'offres) avec le planificateur de Hermes, qui envoie le résultat sur la plateforme choisie ;
- préparer une synthèse à partir de documents déjà publics ;
- rédiger un brouillon que vous relisez, sans envoi automatique.
Observez deux choses pendant les premières semaines. La mémoire : l'agent décide lui-même de ce qu'il retient et cherche dans ses sessions passées (recherche plein texte FTS5). Les skills : après une tâche complexe, Hermes peut écrire une fiche de méthode réutilisable, compatible avec le standard agentskills.io. Relisez ces skills comme la procédure d'un nouveau collègue, avant qu'elles servent sur une tâche qui compte. Pour choisir les tâches suivantes, la grille gratuite proposée en fin de billet aide à les classer.
Mettre à jour sans casser
Depuis la v0.22.0, les mises à jour suivent un canal stable, numéroté selon la convention SemVer. Revenir à la branche de développement demande une commande explicite : hermes update --set-channel main. Pour un agent qui travaille pour vous, ne le faites pas : la branche main reçoit les changements avant qu'ils soient stabilisés.
Le rythme est soutenu : de la v0.22.0 (13 octobre 2026) à la v0.22.5 (notes datées du 22 octobre, publiées le 23), avec des fonctions déplacées vers des plugins en route (hermes mcp serve et le backend Singularity en v0.22.5). Notre méthode tient en quatre gestes : lire les notes de la version visée ; vérifier si une fonction que vous utilisez change de place ; tester la mise à jour sur une copie ; puis seulement mettre à jour l'agent qui travaille. La procédure de mise à jour pas à pas : voir la documentation du projet.
Ce que l'agent garde, et combien de temps
Un réglage mérite d'être connu dès l'installation : sessions.auto_prune, actif par défaut, supprime automatiquement les sessions terminées depuis plus de 90 jours. C'est utile pour ne pas accumuler d'historique, gênant si vous devez garder une trace de ce que l'agent a fait. Décidez de la durée qui vous convient avant le premier vrai usage et, si une trace est nécessaire, exportez le journal ailleurs (recommandation Waimia ; pour modifier ce réglage, voir la documentation du projet).
Les notes des versions v0.21.6 et v0.22 apportent aussi des protections qui jouent sans réglage : la télémétrie partagée est désactivée par défaut, les fichiers de l'agent sont réservés à leur propriétaire, les processus enfants n'héritent plus des secrets des adaptateurs, et les clés Anthropic et OpenAI ne sont jamais envoyées à des hôtes tiers.
Avant d'aller plus loin : huit points à cocher
Recommandations Waimia, à cocher avant de confier d'autres tâches à l'agent :
- La machine est dédiée à l'agent et ne contient aucune donnée de l'entreprise.
- Le backend est isolé, et le test du dossier hôte échoue bien.
- La version installée est notée, sur le canal stable.
- Le compte du modèle a un plafond de dépense.
- Un seul canal est ouvert, appairé, avec l'approbation des commandes active.
- Aucune donnée client n'a été montrée à l'agent.
- La durée de conservation des sessions est décidée, face aux 90 jours par défaut.
- Une personne est nommée pour lire les notes de version et faire les mises à jour.
Si l'un de ces points coince, l'agent n'est pas prêt pour un usage de travail. Le billet agent IA toujours actif : propriétaire ou open source aide aussi à vérifier qu'un moteur ouvert est le bon choix, plutôt qu'un agent d'éditeur ou un agent sur mesure.
Et après ?
- Comprendre le moteur en entier : le guide Hermes Agent couvre le fonctionnement, la sécurité, le coût et le RGPD.
- Passer de l'essai au service : notre intégration de Hermes Agent installe l'agent sur une machine dédiée, isole l'exécution, range les secrets et assure les mises à jour. Elle fait partie de nos agents IA open source : un sprint de cadrage de 10 heures à 999 € HT, puis 99 € HT de l'heure.
- En parler d'abord : réserver l'audit gratuit. Audit gratuit de 45 minutes en visio. Vous repartez avec une cartographie écrite et un ou deux chantiers classés. Le déroulé est décrit sur la page audit IA pour PME.
Classez vos tâches avant de choisir le premier cas
Dix minutes, un classement par priorité en heures par mois : la grille vous le donne tout de suite, sans inscription. Vous pouvez ensuite la recevoir par e-mail pour la garder.