Guide d’installation Hermes Agent 2026 :
macOS en une ligne, Telegram et passerelle 24/7

En 2026, Nous Research a publié en open source Hermes Agent comme processus de longue durée sur votre matériel : mémoire entre sessions, Skills qui s’accumulent, et plus de vingt passerelles de messagerie dont Telegram. Beaucoup d’équipes bloquent dès le premier jour : dépendances cassées, clés API incorrectes ou bot Telegram qui ne répond jamais.

Ce guide s’adresse aux développeurs qui veulent une installation propre sur macOS, Linux ou WSL2 sans assembler Python et Node à la main. Vous obtenez une matrice de choix d’hôte, l’installateur officiel et un parcours en six étapes de hermes doctor à hermes gateway start. À la fin, vous saurez si ~/.hermes/ reste sur un portable ou doit vivre sur un Mac mini toujours en ligne.

01 Points de friction avant l’installation : Hermes n’est pas le même chemin qu’OpenClaw

Hermes et OpenClaw exposent tous deux un Gateway, mais les défauts diffèrent. OpenClaw mise sur un plan de contrôle riche en plugins ; Hermes met l’accent sur la mémoire à trois couches, l’évolution des Skills et MCP. L’installateur officiel tire Python 3.11, Node.js 22, ripgrep et ffmpeg dans ~/.hermes/hermes-agent/venv pour éviter le Python système.

  • Dérive des dépendances : un pip manuel provoque souvent ModuleNotFoundError: dotenv parce que le shell appelle encore le Python système.
  • La veille coupe le Gateway : un MacBook convient pour un POC ; la production exige un hôte qui ne suspend pas pendant cron et messagerie.
  • Lacunes VPS Linux : le mode Gateway API-only sur VPS x86 fonctionne, mais certains chemins d’automation navigateur macOS ne se répliquent pas sur Linux sans travail supplémentaire.
  • Confidentialité des groupes Telegram : les bots ignorent les messages normaux tant que Group Privacy reste actif dans BotFather ; réinvitez le bot après modification.
  • Migration de config : après mise à jour, lancez hermes config check si vous voyez Missing config after update.

L’installation peut tenir en moins de vingt minutes ; la disponibilité et une stratégie de sauvegarde de ~/.hermes/ déterminent la valeur à long terme.

Commandes et comportement suivent la documentation officielle Nous Research ; rouvrez les liens après chaque release.

Installation | Hermes Agent

NousResearch/hermes-agent sur GitHub

02 Prérequis et matrice d’hôtes : où faire tourner la production

L’installateur prend en charge macOS 12+, Ubuntu 20.04+, WSL2 et Termux. PowerShell natif sous Windows est en bêta précoce ; aujourd’hui WSL2 avec le script Linux est le chemin le plus sûr.

Comparaison d’hôtes Hermes Agent (pratique 2026)
Hôte Disponibilité 24/7 Friction d’install Intérêt composé Skills Faiblesse principale
MacBook cassée en veille faible POC seulement mises à jour, fermeture capot
Raspberry Pi 4B 8 Go bonne mais IO limité moyenne Gateway léger OK jobs longs en timeout
VPS Linux x86 élevée moyenne (--skip-browser) mode API stable pas de toolchain macOS native
Location bare metal Mac mini M4 SLA datacenter faible en SSH launchd + UMA adaptés choisir région et durée

Minimums officiels : environ 4 Go de RAM pour Gateway plus APIs cloud ; 16 Go de mémoire unifiée si vous exécutez des modèles locaux ou une automation navigateur lourde. Réservez 1,5 Go de disque pour l’installation de base et davantage pour le cache Skills ; en production, 20 Go SSD de marge est prudent.

03 Installation en une ligne et contrôle de santé sur macOS et Linux

Exécutez sur l’hôte cible (aligné sur le README officiel ; après chaque release vérifiez le chemin du script sur la branche main du dépôt) :

install.sh 
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
Serveur sans interface graphique :
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash -s -- --skip-browser
source ~/.zshrc
hermes doctor
hermes --version

L’installateur installe typiquement uv, épingle Python 3.11, installe Node.js 22, clone le dépôt dans ~/.hermes/hermes-agent/ et expose la CLI hermes. En cas de succès, un message du type installed at ~/.hermes apparaît.

hermes doctor vérifie Python, Node, ripgrep, ffmpeg, PATH et clés API. Corrigez chaque échec avant hermes setup pour ne pas reporter les problèmes au Gateway.

La configuration du canal Telegram est détaillée dans le guide Messaging officiel.

Telegram | Hermes Agent User Guide

04 Six étapes : modèle, premier chat, Telegram et Gateway toujours actif

  1. Configurer le LLM : lancez hermes setup ou hermes model pour OpenRouter, Anthropic, OpenAI, Ollama, etc. Stockez les clés dans ~/.hermes/.env ou via hermes config set OPENROUTER_API_KEY sk-or-xxxx.
  2. Test fumée CLI : exécutez hermes avec une tâche vérifiable, par exemple compter les fichiers du répertoire courant.
  3. Créer le bot Telegram : utilisez @BotFather avec /newbot ; récupérez votre identifiant numérique via @userinfobot.
  4. Brancher le Gateway : hermes gateway setup, choisissez Telegram, collez token et utilisateurs autorisés, ou définissez TELEGRAM_BOT_TOKEN et TELEGRAM_ALLOWED_USERS.
  5. Test au premier plan : hermes gateway en avant-plan, envoyez un message depuis le téléphone ; en groupe, désactivez la confidentialité du bot puis réinvitez-le.
  6. Daemoniser : sur macOS hermes gateway install et hermes gateway start (launchd) ; sur Linux le chemin systemd documenté avec --system si pertinent.
gateway.env 
hermes setup
hermes gateway setup
hermes gateway install
hermes gateway start
hermes gateway status

Sur un Mac bare metal CALMVPS : choisissez d’abord la mémoire M4 et la région sur la page tarifs, connectez-vous en SSH, exécutez les mêmes commandes qu’en local, et archivez tout ~/.hermes/ avant de changer d’hôte.

05 Valeurs de référence, erreurs courantes et quand CALMVPS convient

  • Pile installateur : uv, Python 3.11, Node.js 22, ripgrep, ffmpeg selon la doc Installation ; confirmez avec hermes --version après mise à jour.
  • Répertoire d’état : ~/.hermes/ contient env, skills, memories et état Gateway ; la migration exige une sauvegarde complète du répertoire.
  • Profil énergétique M4 : en datacenter, souvent environ 4–6 W au repos et 15–25 W sous charge Agent typique ; validez sur votre compteur.
Erreurs fréquentes d’installation et de Gateway
Symptôme Cause fréquente Action
hermes: command not found PATH non rafraîchi source ~/.zshrc ou nouveau terminal
API key not set LLM non configuré hermes model ou éditer ~/.hermes/.env
groupe sans réponse mode confidentialité bot désactiver Group Privacy, réinviter le bot
Missing config after update schéma de config modifié hermes config check et migrate

Installer Hermes sur un portable souvent fermé casse la continuité du Gateway et le rythme des Skills. Sur un VPS offshore bon marché, il manque la toolchain macOS et la latence peut gêner Telegram. Sur un Raspberry Pi, les jobs longs butent sur les plafonds IO.

Pour Telegram 24/7, daemons compatibles launchd et montée rapide de la RAM, la location bare metal Mac mini M4 CALMVPS est souvent le meilleur défaut production : Apple Silicon dédié, livraison SSH, durées mensuelles flexibles. Modèles et tarifs sur la page tarifs CALMVPS ; commande via commander un Mac mini M4.