Installer Hermes Agent : tutoriel complet sur Windows, Mac, Linux et VPS

Pour installer Hermes Agent, l'agent IA open source de Nous Research, une seule commande suffit : le script officiel install.sh sur Linux, macOS ou WSL2, ou install.ps1 dans PowerShell sur Windows. Le script installe lui-même Python, Node.js et les outils ; il vous faut seulement Git. Ensuite, trois commandes font l'essentiel : hermes model pour choisir le modèle, hermes gateway setup pour le brancher sur Telegram ou Slack, hermes doctor pour vérifier. Le modèle choisi doit accepter au moins 64 000 tokens de contexte, sinon Hermes refuse de démarrer.

Chaque commande a été relue le 19 octobre 2026 sur la documentation officielle (nouvel onglet) et le dépôt GitHub (nouvel onglet), dont la dernière version est la v0.22.2, du 15 octobre 2026 (nouvel onglet). Le projet bouge vite : en cas d'écart, la documentation fait foi.

Hermes Agent, c'est quoi exactement ?

Hermes Agent est un agent IA personnel que vous installez sur votre ordinateur ou sur un serveur. Ce n'est pas une page de discussion comme ChatGPT : il exécute des commandes, lit et écrit des fichiers, navigue sur le web, garde une mémoire d'une session à l'autre et vous répond sur votre messagerie. Quand il réussit une tâche complexe, il en tire une « compétence » (skill) pour la refaire mieux.

Trois points comptent avant d'installer, tous écrits dans la FAQ officielle (nouvel onglet) (lue le 19 octobre 2026) :

• le logiciel est gratuit, sous licence MIT : vous ne payez que le modèle d'IA que vous branchez dessus ;
• il n'envoie aucune télémétrie : vos échanges ne partent que vers le fournisseur de modèle que vous choisissez ;
• les conversations, la mémoire et les compétences restent dans le dossier ~/.hermes de la machine.

Je le dis franchement : il faut savoir copier une commande et lire un message d'erreur. Si c'est votre cas, ce guide suffit.

Quels sont les prérequis pour installer Hermes ?

D'après la page d'installation (nouvel onglet) (lue le 19 octobre 2026) :

• Git, curl, tar et un utilitaire SHA-256 sur Linux et macOS. Sur Windows, le script installe Git pour Windows s'il manque.
• Pas besoin d'installer Python vous-même : le script fournit Python 3.14, Node.js, npm, ripgrep et FFmpeg.
• Sur Linux, la bibliothèque libatomic.so.1 pour Node.js, que le script installe au besoin.
• Un fournisseur de modèle : un compte (Nous Portal, Anthropic, OpenAI…), une clé API, ou un modèle local.

La page des plateformes (nouvel onglet) place en priorité haute macOS sur puce Apple, Windows 10 et 11, Linux, WSL2 et Docker. Elle ne donne aucune exigence de mémoire ni de disque. L'hébergeur BinaryLane, dans un guide modifié le 15 octobre 2026 (nouvel onglet), indique qu'un serveur à 1 vCPU et 2 Go de RAM suffit, et que l'installation demande environ 6 Go de disque.

Comment installer Hermes Agent pas à pas ?

Installer Hermes Agent sur Windows

Deux voies, sans passer par WSL2. La plus simple : l'application Hermes Desktop, téléchargée sur le site de Hermes, que vous installez en ouvrant le fichier .appinstaller. La seconde, en ligne de commande, dans PowerShell :

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

Le code s'installe dans %LOCALAPPDATA%\hermes. La documentation prévient que certains antivirus mettent en quarantaine le fichier uv.exe : c'est un faux positif, et elle conseille d'autoriser le dossier entier plutôt que le fichier, car celui-ci change à chaque mise à jour. WSL2 reste possible, avec la commande Linux ci-dessous.

Installer Hermes Agent sur Mac

Sur un Mac à puce Apple, l'application Hermes Desktop est la voie recommandée : vous ouvrez le DMG et vous glissez Hermes.app dans Applications. Sur un Mac Intel, ou si vous préférez le terminal, utilisez la commande du paragraphe suivant, puis rechargez le terminal avec source ~/.zshrc.

Installer Hermes Agent sur Linux ou sur un VPS Ubuntu

Dans un terminal :

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

Puis rechargez le terminal et lancez l'agent :

source ~/.bashrc

hermes

Sur une machine qui compte, je préfère télécharger le script, le lire, puis le lancer : vous savez ce que vous exécutez. Ses options s'affichent avec bash install.sh --help. Par défaut, il installe aussi la navigation web (Chromium) et le contrôle de l'ordinateur : si l'agent n'en a pas besoin, ajoutez --skip-browser et --skip-computer-use (sous Windows : -SkipBrowser, -SkipComputerUse). Et ne le lancez pas avec sudo : la FAQ le déconseille, c'est une cause d'erreur « Permission denied ».

Installer Hermes Agent avec Docker

L'image officielle s'appelle nousresearch/hermes-agent, et les commandes complètes sont sur la page Docker (nouvel onglet) :

docker pull nousresearch/hermes-agent:latest

Attention : hermes update ne marche pas dans Docker. On récupère la nouvelle image et on recrée le conteneur, les données sont conservées.

Comment configurer Hermes Agent et choisir le modèle ?

Au premier lancement, hermes setup propose trois chemins, décrits dans le démarrage rapide (nouvel onglet) (lu le 19 octobre 2026) :

1. Quick Setup : connexion au Nous Portal, qui fournit le modèle et des outils prêts (recherche web, images, voix). Raccourci : hermes setup --portal.
2. Full Setup : vous configurez chaque fournisseur et chaque outil.
3. Blank Slate : presque tout est désactivé, sauf le modèle, les fichiers et le terminal. C'est le bon départ si vous voulez maîtriser ce que l'agent peut toucher.

Pour changer de modèle à tout moment :

hermes model

Hermes accepte des abonnements (Nous Portal, Anthropic, OpenAI Codex, GitHub Copilot), des clés API (OpenRouter, DeepSeek, Google AI Studio et bien d'autres) et tout serveur compatible OpenAI, y compris local. Les clés se rangent avec hermes config set, qui les écrit dans ~/.hermes/.env :

hermes config set OPENROUTER_API_KEY votre-clé

Trois pièges, relevés dans la page des fournisseurs (nouvel onglet) (lue le 19 octobre 2026) :

• Le contexte minimum. Hermes exige 64 000 tokens de contexte. Ollama démarre par défaut à 4 096 tokens sur une carte graphique de moins de 24 Go : il faut monter ce réglage côté serveur, Hermes ne peut pas le faire à sa place.
• L'abonnement Claude. La connexion par compte Claude ne marche qu'avec un forfait Max et des crédits d'usage supplémentaire achetés : Hermes consomme ces crédits, pas le forfait inclus. Avec Claude Pro, passez par une clé API.
• Les modèles Hermes 4. Malgré le nom, la page Nous Portal (nouvel onglet) les déconseille dans l'agent : ils sont réglés pour la discussion, pas pour appeler des outils.

Installer Hermes Agent en local, avec un modèle sur votre machine

Pour que rien ne sorte de chez vous, faites tourner le modèle lui-même en local. La FAQ (nouvel onglet) décrit la marche avec Ollama :

1. Installez Ollama et téléchargez un modèle qui sait appeler des outils.
2. Réglez son contexte à 64 000 tokens au moins, côté Ollama (paramètre num_ctx). Vérifiez avec ollama ps.
3. Dans hermes model, choisissez « Custom endpoint » et l'adresse http://localhost:11434/v1, sans clé API.
4. Si vous avez changé num_ctx, indiquez la même valeur dans model.context_length côté Hermes.

Avec LM Studio, l'adresse est http://localhost:1234/v1, et l'appel d'outils demande la version 0.3.6 au moins. Le modèle fait l'essentiel de la facture : prix et réglages sont comparés dans comment faire tourner un agent IA pas cher.

Comment fonctionne la mémoire de Hermes ?

La mémoire tient dans deux fichiers du dossier ~/.hermes/memories, selon la page Mémoire (nouvel onglet) (lue le 19 octobre 2026) :

• MEMORY.md : les notes de l'agent sur votre environnement et vos habitudes, limitées à 2 200 caractères ;
• USER.md : votre profil, vos préférences, votre façon de parler, limité à 1 375 caractères.

C'est court, et c'est voulu. La mémoire est chargée au début de chaque session et ne bouge plus ensuite : ce que l'agent note aujourd'hui, il ne le « voit » qu'à la session suivante. Tapez /new entre deux sujets. L'historique complet, lui, reste consultable par l'agent, dans ~/.hermes/state.db.

Pour un usage professionnel, deux réglages :

• Validez ce qu'il retient. Avec /memory approval on, l'agent vous soumet chaque écriture en mémoire : une erreur ne devient pas une vérité.
• Écrivez son identité. Le fichier SOUL.md dit qui il est et pour qui il travaille : votre activité, vos clients, votre ton.

Quels outils et quelles connexions brancher ?

La commande hermes tools ouvre la liste des outils (web, terminal, fichiers, navigateur, images, voix, tâches planifiées…), activables plateforme par plateforme. N'activez que ce qui sert : chaque outil ouvert est une porte de plus.

Le brancher sur Telegram

C'est la connexion la plus utile : vous parlez à l'agent depuis votre téléphone. Les étapes de la page Telegram (nouvel onglet) :

1. Écrivez à @BotFather, envoyez /newbot, choisissez un nom puis un identifiant qui finit par « bot ». Gardez le jeton reçu.
2. Récupérez votre identifiant numérique auprès de @userinfobot.
3. Lancez hermes gateway setup et choisissez Telegram, ou écrivez TELEGRAM_BOT_TOKEN et TELEGRAM_ALLOWED_USERS dans ~/.hermes/.env.
4. Lancez hermes gateway, écrivez au bot, puis envoyez /sethome : les messages des tâches planifiées arriveront là.

La même passerelle gère Discord, Slack, WhatsApp, Signal, l'e-mail et Microsoft Teams.

Les tâches planifiées

L'agent travaille aussi sans que vous lui parliez. Exemple, au format de la page Cron (nouvel onglet) :

hermes cron create "weekdays at 7am" "Résume les e-mails reçus depuis hier et liste ce qui demande une réponse"

Vous pouvez aussi le demander en français dans la conversation : l'agent crée la tâche lui-même.

Les connexions MCP

Pour relier l'agent à un agenda, un CRM ou un logiciel métier, déclarez le connecteur sous la clé mcp_servers de ~/.hermes/config.yaml. La page MCP (nouvel onglet) montre comment le limiter à quelques outils avec la clé include : faites-le toujours. /reload-mcp recharge ensuite la liste.

Où héberger Hermes : votre poste, un serveur maison ou un VPS ?

Pour qu'il tourne en continu, la page Messagerie (nouvel onglet) donne la commande qui installe la passerelle comme un service :

hermes gateway install

Sur Linux, c'est un service systemd. Sur un VPS sans écran, ajoutez sudo loginctl enable-linger suivi de votre nom d'utilisateur, pour que le service survive à la déconnexion, ou installez-le au démarrage avec sudo hermes gateway install --system. Sur Windows, la commande crée une tâche planifiée qui démarre à l'ouverture de session, mais ne relance pas la passerelle si elle plante.

Mon avis : dès que l'agent doit répondre à des messages, prenez un VPS. Un petit suffit, les prix sont comparés dans l'article sur le coût d'un agent IA.

Comment sécuriser Hermes sur une machine pro ?

Sur un chantier, on ne laisse pas les clés du dépôt sur le contact. Un agent qui exécute des commandes, c'est pareil. L'essentiel de la page Sécurité (nouvel onglet), lue le 19 octobre 2026 :

• Isolez l'exécution. Par défaut, le terminal de l'agent tourne sur votre machine sans isolation. Passez-le dans un conteneur : hermes config set terminal.backend docker. Mieux encore, faites tourner l'agent sur une autre machine que celle de la comptabilité.
• Gardez les validations. Le mode par défaut, smart, fait juger chaque commande risquée par un modèle ; le mode manual demande votre accord à chaque fois. Jamais de --yolo sur une machine pro.
• Fermez la messagerie. Renseignez toujours TELEGRAM_ALLOWED_USERS ou GATEWAY_ALLOWED_USERS, et ne mettez jamais GATEWAY_ALLOW_ALL_USERS=true sur un agent qui a accès au terminal.
• Rangez les secrets. Les clés vont dans ~/.hermes/.env, protégé par chmod 600.
• Un compte dédié. Lancez la passerelle sous un utilisateur non administrateur, et fixez terminal.cwd sur un dossier de travail, loin de vos documents sensibles.
• Méfiez-vous du contenu. Un e-mail ou une page web peut contenir des instructions piégées. Hermes scanne ses fichiers de contexte, mais sa documentation précise elle-même qu'il s'agit d'heuristiques.
• Mettez à jour. hermes update, régulièrement.

Les erreurs courantes et leurs solutions

Tirées de la FAQ officielle (nouvel onglet) :

• « hermes: command not found » : rechargez le terminal (source ~/.bashrc) ou ouvrez-en un nouveau.
• « Permission denied » à l'installation : ne lancez pas le script avec sudo, supprimez un ancien /usr/local/bin/hermes, relancez.
• Erreur 400 au premier lancement : souvent un nom de modèle faux ou, chez OpenRouter, des crédits épuisés.
• Contexte dépassé : tapez /compress ou ouvrez une nouvelle session, et réglez model.context_length sur la vraie taille de contexte du modèle.
• La passerelle ne démarre pas : hermes gateway status, puis le journal ~/.hermes/logs/gateway.log.

En cas de doute, hermes doctor fait le tour et signale ce qui manque.

Questions fréquentes

Hermes Agent est-il gratuit ?

Oui, le logiciel est gratuit et open source, sous licence MIT. Vous payez le modèle d'IA que vous branchez, à l'usage ou par abonnement, et la machine qui l'héberge si ce n'est pas la vôtre. Un modèle local ne coûte que le matériel et l'électricité.

Peut-on installer Hermes Agent sur Windows sans WSL2 ?

Oui. La documentation actuelle classe Windows 10 et 11 parmi les plateformes prioritaires, avec le script install.ps1 dans PowerShell ou l'application Hermes Desktop. WSL2 reste possible, mais la FAQ y déconseille systemd pour la passerelle et propose hermes gateway run dans tmux.

Hermes peut-il tourner avec un modèle local, sans Internet ?

Oui, avec Ollama, LM Studio, vLLM ou llama.cpp, à condition de régler un contexte d'au moins 64 000 tokens, ce qui demande une machine bien dotée en mémoire. Les outils web, eux, ont besoin d'Internet.

Comment mettre Hermes à jour ?

Avec hermes update pour une installation par script. Une installation Docker se met à jour en récupérant la nouvelle image, et une installation Desktop par son propre mécanisme. hermes doctor indique quelle méthode vous avez utilisée.

Un agent installé ne sert à rien sans un travail précis : commencez par une seule tâche répétitive. Des exemples concrets, tirés du bâtiment, le métier que je connais : ce qu'un agent IA peut faire pour une entreprise. Et si ce sont les demandes de clients qui vous manquent, le diagnostic est gratuit : recevoir les chiffres de ma zone.