Guide · Intermédiaire · 11 min
Hermes Agent, guide de référence : installation, mémoire et compétences, modèles, coûts, limites
Hermes Agent exécute des tâches avec outils, mémoire et compétences. Guide pour l’installer, choisir son modèle, contrôler les coûts et limiter les risques.

Hermes Agent est un agent de Nous Research qui associe un modèle de langage, des outils, une mémoire persistante et des compétences réutilisables pour accomplir des tâches. Vous pouvez l’installer sur votre machine, choisir son fournisseur de modèle et contrôler ses accès ; son coût réel dépend ensuite de l’inférence, des services utilisés et de l’hébergement.
Ce qu’Hermes Agent fait réellement
Le logiciel reçoit une demande, utilise les outils disponibles, examine leurs résultats et poursuit son travail. Sa particularité tient notamment à la conservation de faits et de procédures entre les sessions. Cette continuité peut éviter de répéter des consignes, mais elle demande aussi de vérifier ce qui a été enregistré.
Le dépôt officiel de Nous Research publie le code sous licence MIT. Le relevé du site, octobre 2026, indique la version v0.22.5 datée du 23 octobre 2026. Ce repère identifie un état du projet ; les commandes de ce guide suivent la documentation officielle consultée pour sa rédaction.
Il faut distinguer l’agent du modèle qu’il utilise. Installer Hermes ne revient pas à installer automatiquement un modèle local. Vous configurez séparément le programme qui orchestre les actions et le service qui produit les réponses.
Hermes s’adresse aux personnes capables de gérer un terminal, des identifiants et des fichiers de configuration. Pour situer cette approche parmi les autres solutions, consultez l’annuaire des agents IA. L’article Hermes Agent : installation, coûts et limites constitue une lecture voisine ; cette page couvre surtout les choix nécessaires à une utilisation durable.
Prérequis : préparer l’environnement et les accès
Avant l’installation, choisissez où l’agent travaillera et quelles données il pourra atteindre. Pour un premier essai, préférez un compte utilisateur ordinaire et un dossier contenant des documents non sensibles. Évitez de commencer avec vos sauvegardes, vos accès de production ou votre messagerie professionnelle complète.
Préparez les éléments suivants :
- un système couvert par la documentation officielle ;
- un terminal correspondant à votre environnement ;
- un accès réseau pour télécharger le logiciel et contacter une API distante ;
- un compte fournisseur ou un serveur de modèle déjà accessible ;
- un moyen de suivre les dépenses chez le fournisseur ;
- des copies des fichiers utilisés pour les essais.
La puissance nécessaire dépend surtout du lieu où tourne le modèle. Une API distante déporte l’inférence ; un modèle local exige que votre matériel supporte ses poids et son contexte. Il n’existe donc pas de configuration matérielle universelle à déduire du seul nom Hermes.
Définissez aussi un premier objectif vérifiable : résumer un document public, retrouver des informations dans un dossier d’essai ou préparer une procédure sans l’exécuter. Une demande limitée facilite le diagnostic : vous pourrez distinguer un problème d’installation d’une erreur du modèle ou d’un outil indisponible.
1. Installer depuis la documentation officielle
Les commandes ci-dessous proviennent du guide officiel d’installation, consulté pour cette page le 24 octobre 2026. Elles téléchargent puis exécutent un script : vérifiez le domaine et examinez le script si votre politique informatique l’exige.
Sous Linux, macOS ou WSL2 :
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Sous Windows natif, ouvrez PowerShell :
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
Ce sont des voies alternatives : utilisez celle de votre environnement. La documentation propose également des paquets pour l’application de bureau sur macOS et Windows. Vérifiez les restrictions matérielles avant de choisir un paquet ; le paquet macOS documenté vise Apple Silicon.
L’installation depuis les sources prépare le programme et ses dépendances. Elle peut aussi télécharger des composants destinés à la navigation et à l’utilisation de l’ordinateur. Une installation terminée ne prouve donc pas que chaque fonction optionnelle est prête : lisez les messages de fin et les éventuels échecs de téléchargement.
Pour une installation POSIX, la documentation situe par défaut le code dans ~/.hermes/hermes-agent/ et les données dans ~/.hermes/. L’installation source Windows emploie un emplacement sous %LOCALAPPDATA%\hermes\. Gardez cette distinction en tête lors des sauvegardes et du dépannage.
2. Configurer le modèle et valider une conversation
Le démarrage rapide officiel propose un assistant de configuration :
hermes setup
Pour choisir ou changer interactivement le fournisseur et le modèle :
hermes model
La voie intégrée proposée avec Nous Portal utilise cette commande :
hermes setup --portal
Elle configure l’accès au fournisseur et aux outils de sa passerelle. Examinez les conditions de facturation avant de retenir cette option. Pour gérer vos propres accès, choisissez le parcours de configuration correspondant plutôt que de supposer qu’un abonnement existant couvre tous les appels.
Lancez ensuite l’interface :
hermes
Demandez une réponse simple, puis une lecture de fichier dans votre dossier d’essai. Vérifiez le fournisseur affiché, la cohérence de la réponse et l’usage effectif de l’outil. Ne branchez pas encore d’automatisation.
Vous pouvez vérifier la reprise de la dernière session :
hermes --continue
La documentation consultée impose un contexte minimal de 64 000 tokens. Avec un serveur local, contrôlez la capacité réellement configurée, pas seulement celle annoncée pour le modèle.
Le mode de configuration Blank Slate constitue une base réduite, mais laisse notamment les opérations sur fichiers et le terminal disponibles. Il désactive aussi la mémoire et les compétences : réactivez explicitement les fonctions nécessaires avant de tester leur persistance.
3. Comprendre et sauvegarder la configuration
La référence officielle de configuration distingue les réglages ordinaires, les secrets et les identifiants d’authentification. Pour l’installation POSIX par défaut, les principaux emplacements sont :
| Élément | Emplacement | Précaution |
|---|---|---|
| Réglages | ~/.hermes/config.yaml | Conserver une copie avant modification |
| Clés et secrets | ~/.hermes/.env | Exclure des publications et dépôts partagés |
| Authentification | ~/.hermes/auth.json | Protéger comme un accès au compte |
| Mémoire | ~/.hermes/memories/ | Relire les informations conservées |
| Compétences | ~/.hermes/skills/ | Suivre les procédures et leurs changements |
Les commandes documentées permettent d’examiner les réglages et de rechercher des options manquantes ou des sélections devenues obsolètes :
hermes config
hermes config check
Pour ouvrir le fichier de configuration dans votre éditeur :
hermes config edit
Évitez de modifier plusieurs couches simultanément. Changez un réglage, relancez un essai connu, puis notez le résultat. Une faute dans une clé peut produire un fichier lisible sans entraîner le comportement attendu.
Séparez également sauvegarde et partage. Une archive utile pour restaurer votre installation peut contenir des clés, de l’historique et des informations personnelles. Pour demander de l’aide, préparez plutôt un extrait réduit et expurgé. Ne publiez pas le dossier de données complet dans un ticket de support.
Mémoire, historique et compétences : trois fonctions distinctes
La mémoire d’agent désigne ici des informations sélectionnées pour survivre aux conversations. Elle ne remplace ni l’historique complet ni les fichiers de travail.
La documentation officielle de la mémoire décrit deux fichiers : MEMORY.md pour les notes durables et USER.md pour les préférences et attentes de l’utilisateur. Leur contenu est chargé comme un instantané au début d’une session. Une modification enregistrée pendant celle-ci ne réécrit donc pas immédiatement cet instantané.
| Mécanisme | Contenu | Vérification utile |
|---|---|---|
| Contexte courant | Échanges et résultats de la tâche active | L’agent dispose-t-il du bon document ? |
| Historique des sessions | Conversations passées consultables | Retrouve-t-il la bonne source ? |
| Mémoire persistante | Faits et préférences sélectionnés | Le fait enregistré est-il exact ? |
| Compétences | Procédures réutilisables | La procédure fonctionne-t-elle encore ? |
La mémoire est limitée et ne se compacte pas automatiquement lorsqu’une écriture dépasse sa capacité. L’agent doit alors raccourcir, regrouper ou retirer des entrées.
Pour tester la persistance, faites enregistrer une convention anodine, terminez la tâche et ouvrez une nouvelle session. Dans les conversations de messagerie prolongées, la documentation recommande une frontière explicite :
/new
Un redémarrage de machine ne suffit pas nécessairement à créer cette frontière. Ne faites pas non plus écrire plusieurs processus dans le même répertoire de données : utilisez des profils distincts. L’article sur la mémoire des agents IA approfondit les différences entre souvenir, recherche et contexte.
4. Vérifier les compétences avant de les réutiliser
Une compétence contient des instructions mobilisées pour une tâche. Le système de compétences officiel utilise notamment des fichiers SKILL.md, dont le contenu détaillé est chargé à la demande. Hermes peut créer, modifier et supprimer des compétences.
Vous pouvez demander l’inventaire disponible avec cette commande documentée :
hermes chat --toolsets skills -q "What skills do you have?"
Le fait qu’une procédure soit disponible ne prouve pas sa pertinence. Avant de la retenir, examinez son objectif, ses prérequis, ses actions externes et sa méthode de vérification. Une compétence qui publie un document demande une autre confiance qu’une procédure limitée à sa mise en forme.
La création autonome peut conserver une méthode utile, mais aussi une correction circonstancielle ou une commande devenue obsolète. Le terme d’apprentissage ne signifie pas ici que les paramètres du modèle ont été réentraînés. Vous devez pouvoir retrouver la procédure enregistrée et comprendre ses effets.
Pour une compétence interne, précisez quand l’utiliser, les entrées attendues, les actions autorisées et les conditions d’arrêt. Testez-la sur une copie des données, avec un cas normal et un cas incomplet. Vérifiez qu’elle signale les informations manquantes au lieu de les inventer.
Enfin, conservez une copie des procédures validées pour pouvoir comparer les changements. Le guide des skills des agents IA détaille cette méthode de rédaction et de contrôle.
Choisir le modèle selon la tâche et les données
La documentation de configuration des modèles décrit la sélection du fournisseur et du modèle. Ce choix doit porter sur la qualité des actions, la compatibilité des outils, la longueur du contexte et les conditions de traitement des données.
OpenRouter fait partie des fournisseurs répertoriés dans le démarrage rapide. Un point d’accès compatible peut aussi servir à joindre une infrastructure locale, notamment avec Ollama. Dans tous les cas, vérifiez l’adresse, l’identifiant exact du modèle et les fonctions exposées par le serveur.
| Critère | API distante | Inférence locale |
|---|---|---|
| Exploitation | Service géré par le fournisseur | Serveur et modèle à entretenir |
| Dépenses | Consommation ou offre du fournisseur | Matériel, énergie et administration |
| Données | Contenu transmis au service choisi | Flux à vérifier sur votre infrastructure |
| Capacité | Dépend de l’offre accessible | Dépend du matériel et de la configuration |
Un modèle qui rédige correctement peut mal gérer les outils. Évaluez sa capacité à choisir une action pertinente, interpréter un échec et s’arrêter lorsqu’il manque une autorisation.
Utilisez le même petit ensemble de tâches pour comparer les options : lecture d’un document, extraction vérifiable, erreur volontaire d’accès et demande ambiguë. Notez les résultats utilisables et les interventions nécessaires. Un changement de modèle peut aussi modifier la manière dont Hermes sélectionne sa mémoire et suit ses compétences ; reprenez ces vérifications après migration.
Coûts : budgéter le travail complet
La licence du logiciel ne détermine pas le prix d’exploitation. Votre budget rassemble l’accès au modèle, les outils externes, l’infrastructure et le temps consacré à relire ou réparer les résultats. Sans ces postes, une estimation mensuelle reste incomplète.
Pour les API facturées en tokens, le calcul de base additionne les tokens d’entrée multipliés par leur tarif et les tokens de sortie multipliés par le leur. Les éventuels mécanismes de cache et les autres modalités contractuelles doivent être traités séparément. Le calculateur de prix LLM aide à poser ces hypothèses.
Un agent peut multiplier les appels pour une même demande. Il ajoute des observations, relit du contexte, tente une correction ou explore une piste infructueuse. Une réponse finale courte peut donc masquer un travail intermédiaire conséquent.
Pour construire un budget utile :
- relevez les dépenses sur des tâches représentatives ;
- comptez les tâches acceptées après vérification ;
- isolez les échecs et les reprises ;
- ajoutez l’hébergement et les services annexes ;
- comparez la dépense au travail effectivement terminé.
Ne confondez pas un avertissement et un plafond bloquant. Vérifiez chez votre fournisseur ce qui se passe lorsque le budget est atteint, puis testez ce comportement sur un accès dédié. Limitez aussi les recherches ouvertes : une liste de documents et un résultat attendu réduisent les explorations inutiles.
Limites et sécurité : contrôler les effets des actions
La documentation officielle de sécurité décrit plusieurs protections, dont les autorisations utilisateur, l’approbation de commandes dangereuses et l’isolation du terminal. Leur présence ne garantit pas qu’une opération est correcte sur le plan métier.
Une commande peut être techniquement ordinaire et envoyer le mauvais fichier au mauvais destinataire. Définissez donc vos validations selon les conséquences : publication, suppression, paiement ou modification de données partagées.
La configuration documentée permet de choisir un terminal conteneurisé :
hermes config set terminal.backend docker
Cette commande suppose un environnement Docker fonctionnel. Vérifiez les répertoires montés, les secrets disponibles et les connexions réseau ; un conteneur doté d’accès étendus conserve des effets possibles sur votre environnement.
L’injection de prompt reste un autre risque : un document consulté peut contenir une instruction qui cherche à détourner l’agent. Traitez les pages, messages et résultats d’outils comme des données, puis contrôlez toute demande d’accès supplémentaire ou de transfert.
Enfin, une mémoire locale peut être incluse dans les requêtes envoyées au fournisseur. Stockage local et inférence locale sont deux décisions distinctes. Le guide pour sécuriser un agent IA complète ces vérifications. Pour commencer, gardez les secrets hors des documents de travail et n’accordez que les accès nécessaires à la tâche.
Problèmes fréquents
La commande de lancement est introuvable
Ouvrez un nouveau terminal et vérifiez les messages de l’installateur. Sous Bash, le démarrage rapide propose de recharger la configuration du shell :
source ~/.bashrc
Ne répétez pas l’installation avec des droits supplémentaires sans diagnostic. Vérifiez d’abord le compte utilisé et l’emplacement du lanceur.
Le programme démarre, mais le modèle ne répond pas
Reprenez la sélection interactive du fournisseur. Contrôlez l’authentification, les crédits, l’adresse du serveur et l’identifiant du modèle. Pour une inférence locale, vérifiez aussi le contexte configuré. Une erreur d’accès ne se corrige pas en ajoutant des compétences.
L’agent semble oublier une consigne
Vérifiez que la mémoire est activée, que l’information a été enregistrée et que vous utilisez le même profil. Testez ensuite une nouvelle session. Si l’information provenait seulement d’un document lu précédemment, elle n’a pas nécessairement été retenue comme fait durable.
Une compétence ne produit plus le bon résultat
Relisez la procédure et comparez ses prérequis à l’environnement actuel. Identifiez l’étape qui échoue avant de demander une réécriture générale. Conservez le message d’erreur et testez la correction sur les données d’essai.
La dépense augmente sans résultat exploitable
Interrompez la tâche et examinez les appels répétés, les erreurs d’outils et les recherches trop larges. Reformulez un objectif avec un livrable précis et une condition d’arrêt. Reprenez ensuite un essai limité plutôt que de prolonger une boucle déjà défaillante.
Checklist avant un usage régulier
Une installation est prête lorsque vous savez expliquer où elle stocke ses données, quel service reçoit ses requêtes et quels effets ses outils peuvent produire.
- L’installation provient du domaine officiel et les erreurs ont été examinées.
- Le fournisseur, le modèle et le contexte effectif sont identifiés.
- Une tâche simple réussit et sa session peut être reprise.
- La persistance d’une information anodine a été vérifiée.
- Les compétences retenues ont été relues et testées.
- Les secrets sont exclus des documents et des partages.
- Les accès aux fichiers et au réseau correspondent au besoin.
- Les opérations engageantes nécessitent une validation adaptée.
- Les dépenses sont suivies et les limites comprises.
- Une sauvegarde permet de restaurer la configuration et les procédures.
Après une mise à jour ou un changement de fournisseur, rejouez vos tâches de référence avant de rétablir les automatisations. Vous vérifierez ainsi le comportement de votre installation, au-delà du seul fait que le programme démarre.
Pages liées
Questions fréquentes
Hermes Agent fonctionne-t-il sans abonnement ?
Le logiciel peut être utilisé sans souscrire à une offre commerciale Hermes. Il faut néanmoins lui fournir un accès à un modèle : une API facturée séparément ou un serveur d’inférence que vous exploitez. Les services externes utilisés par ses outils peuvent également être payants.
Hermes Agent apprend-il en modifiant son modèle ?
La mémoire et la création de compétences conservent des informations et des procédures autour du modèle. Elles ne constituent pas, à elles seules, un entraînement de ses paramètres. Une procédure enregistrée peut donc conserver une erreur et doit pouvoir être relue et corrigée.
Peut-on installer Hermes Agent directement sur Windows ?
La documentation officielle consultée pour ce guide propose un installateur PowerShell natif, ainsi qu’une application de bureau. WSL2 reste une autre voie pour utiliser l’installation Linux. Les fonctionnalités disponibles doivent être vérifiées pour le mode d’installation retenu.
La mémoire d’Hermes Agent reste-t-elle confidentielle ?
Un stockage sur votre ordinateur ne garantit pas que son contenu y reste. Les éléments de mémoire intégrés aux requêtes sont transmis au fournisseur du modèle lorsque vous utilisez une API distante. Il faut examiner séparément le stockage, l’inférence et les services appelés par les outils.
Hermes Agent convient-il à une automatisation sans surveillance ?
Commencez par une tâche limitée dont le résultat est vérifiable et réversible. Un fonctionnement sans surveillance demande aussi une politique d’accès, des limites de dépenses, des sauvegardes et un traitement des échecs. Les opérations engageantes doivent conserver une validation adaptée.