# Installer Hermes Agent : tutoriel prudent (v0.22.5) > 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. Source : https://waimia.com/blog/installer-hermes-agent-premier-agent --- [Accueil](/)/[Blog](/blog)/Installer Hermes Agent : un premier agent, pas à pas et prudemment FR Édition française ◉ Disponible ![Un immeuble blanc pris dans un échafaudage rouge, des ouvriers à chaque étage ; au premier plan, une silhouette tient un plan roulé, un grand disque pâle dans le ciel] § Blog · Agents IA # 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. Simon Beros·24 octobre 2026·9 min de lecture [Simon Beros](/equipe/simon-beros)24 octobre 2026 · 9 min de lecture ## En bref - Installer Hermes Agent tient en quelques commandes : un script d'installation, puis `hermes` et l'assistant `hermes 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](/ressources/guides/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 →](/contact?offer=audit-ia-pme&intent=audit) ## 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](/ressources/comparatifs/hermes-agent-vs-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](/ressources/guides/rgpd-agents-ia-checklist) 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](/blog/ia-auto-hebergee-open-webui-pme). Le détail des nouveautés de la v0.22 est dans [Hermes Agent v0.22 : ce qui change](/blog/hermes-agent-v0-22-modeles-locaux-connecteurs). ## É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](/blog/securiser-openclaw-checklist). ## É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](/blog/agents-ia-toujours-actifs-pme) 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](/ressources/guides/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](/services/integration-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](/services/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](/contact?offer=audit-ia-pme&intent=audit). 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](/audit-ia-pme). Partager [X](https://x.com/intent/tweet?url=https%3A%2F%2Fwaimia.com%2Fblog%2Finstaller-hermes-agent-premier-agent&text=Installer%20Hermes%20Agent%C2%A0%3A%20un%20premier%20agent%2C%20pas%20%C3%A0%20pas%20et%20prudemment%20%C2%B7%20Waimia) [LinkedIn](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fwaimia.com%2Fblog%2Finstaller-hermes-agent-premier-agent) § Sources - [Nous Research, dépôt GitHub hermes-agent (README), lu le 24 octobre 2026](https://github.com/NousResearch/hermes-agent) enterprise - [Nous Research, hermes-agent, page des versions, lue le 24 octobre 2026](https://github.com/NousResearch/hermes-agent/releases) enterprise - [Nous Research, Hermes Agent v0.22.0, The Threshold Release (13 octobre 2026)](https://github.com/NousResearch/hermes-agent/releases/tag/v0.22.0) enterprise - [Nous Research, Hermes Agent v0.22.4 (21 octobre 2026)](https://github.com/NousResearch/hermes-agent/releases/tag/v0.22.4) enterprise - [Nous Research, Hermes Agent v0.22.5 (notes du 22 octobre 2026)](https://github.com/NousResearch/hermes-agent/releases/tag/v0.22.5) enterprise - [Nous Research, Hermes Agent v0.21.6 (8 octobre 2026)](https://github.com/NousResearch/hermes-agent/releases/tag/v0.21.6) enterprise - [Agent Skills, standard ouvert des skills (agentskills.io)](https://agentskills.io) research ## 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. [Classer mes tâches](/ressources/outils/grille-taches-a-automatiser) À lire ensuite [§ Blog · Agents IA ### Agent IA toujours actif : Duet, dots, Hermes, OpenClaw, que choisir en PME Agent IA toujours actif en PME : Claude Duet, ChatGPT dots, Hermes Agent ou OpenClaw. Données, contrôle, maintenance, coût, risques et garde-fous. →](/blog/agents-ia-toujours-actifs-pme)[§ Blog · Agents IA ### Agent IA Claude : quatre façons d'en construire un Agent IA Claude : n8n, Claude lui-même, Agent SDK ou Managed Agents. Ce que chaque voie demande, ses limites de données et le bon choix pour une PME. →](/blog/creer-agent-ia-claude)[§ Blog · Conformité IA et RGPD ### Open WebUI : héberger son IA en PME, bonne idée ? Open WebUI, Ollama, modèles ouverts : ce que recouvre une IA auto-hébergée, coût de location daté du 16 octobre 2026, sécurité, CNIL, alternative hybride. →](/blog/ia-auto-hebergee-open-webui-pme) § Auteur [Simon BerosFondateur · Architecte de systèmes IA (forward deployed engineer)](/equipe/simon-beros) § Audit IA Ce sujet vous concerne ? 45 minutes pour en parler sur vos processus. [Réserver l'audit gratuit →](/contact?offer=audit-ia-pme&intent=audit) ## Questions fréquentes Q.01 Comment installer Hermes Agent ? ↓ Par un script d'installation : avec curl sous Linux, macOS et WSL2, en PowerShell sous Windows, par un dépôt APT sous Termux. La commande hermes ouvre ensuite l'interface en terminal, et hermes setup lance l'assistant de configuration ; depuis la v0.22.0, un assistant de premier lancement aide aussi. Prenez la commande exacte dans le README du dépôt NousResearch/hermes-agent, pas dans un billet, et lisez le script avant de l'exécuter. Q.02 Faut-il Docker pour installer Hermes Agent ? ↓ Non, mais nous le recommandons pour un premier agent. Hermes Agent propose six backends intégrés : local, Docker, SSH, Modal, Daytona et Vercel Sandbox. En backend local, l'agent exécute ses commandes sur la machine qui l'héberge. Docker isole cette exécution dans un conteneur sur la même machine ; depuis la v0.22.0, le navigateur et l'utilisation de l'ordinateur y tournent aussi plutôt que sur l'hôte. Q.03 Hermes Agent fonctionne-t-il sous Windows ? ↓ Oui. D'après le README lu le 24 octobre 2026, il s'installe sous Windows par un script PowerShell, ou par le script curl dans WSL2. L'application de bureau, apparue avec les paquets signés de la v0.22.0, n'existe sous Windows qu'en MSIX, pour Windows 11 22H2 ou plus récent. Pour un agent qui doit tourner en continu, nous recommandons plutôt une machine ou un serveur dédié. Q.04 Peut-on faire tourner Hermes Agent avec un modèle local ? ↓ Oui, depuis la v0.22.0 du 13 octobre 2026. Hermes télécharge et lance des modèles locaux en un clic via llama.cpp, et son catalogue indique lesquels tiennent sur votre carte graphique et votre mémoire. Les notes citent Qwen3.8 27B, Qwen3.6 35B-A3B, DeepSeek V4 Flash et tout modèle GGUF de Hugging Face. La qualité sur vos tâches reste à tester avant tout usage de travail. Q.05 Comment mettre à jour Hermes Agent sans risque ? ↓ Restez sur le canal stable, numéroté en SemVer depuis la v0.22.0, et n'utilisez pas hermes update --set-channel main, qui ramène à la branche de développement. Avant chaque mise à jour, lisez les notes de version : la v0.22.5 a déplacé hermes mcp serve et le backend Singularity vers des plugins. Testez sur une copie, puis mettez à jour l'agent qui travaille. Le détail de la procédure figure dans la documentation du projet. Q.06 Hermes Agent supprime-t-il les anciennes conversations ? ↓ Oui, par défaut. Le réglage sessions.auto_prune, actif dès l'installation, supprime les sessions terminées depuis plus de 90 jours. C'est utile pour limiter les données conservées, mais gênant si vous devez garder une trace des actions de l'agent. Décidez de la durée avant le premier vrai usage et, si nécessaire, exportez le journal hors de la machine. La façon de modifier ce réglage est décrite dans la documentation du projet. Un agent IA aurait-il sa place dans votre équipe ? L'audit gratuit de 45 minutes part de vos tâches réelles et dit par où commencer, ou s'il vaut mieux ne rien faire. [Réserver l'audit gratuit →](/contact?offer=audit-ia-pme&intent=audit) Explorer aussi ## Sur le même sujet Services - [Agents IA open source : déploiement et exploitation](/services/agents-ia-open-source) - [Intégration Hermes Agent en entreprise](/services/integration-hermes-agent) À lire - [Hermes Agent v0.22 : modèles locaux et connecteurs](/blog/hermes-agent-v0-22-modeles-locaux-connecteurs) - [OpenClaw 2.0 : changements et migration](/blog/openclaw-2-0-migration-changements) - [Sécuriser OpenClaw : checklist avant production](/blog/securiser-openclaw-checklist) - [Agent IA toujours actif : sept missions pour une PME](/blog/agent-ia-toujours-actif-missions-pme)