2026 — Guide d'installation Hermes Agent :
macOS / Linux et Telegram Gateway 7j/7

Si vous évaluez en 2026 l'Hermes Agent open source de Nous Research, le blocage vient rarement du prompt engineering, mais de la chaîne script d'installation, dépendances Python/Node, clé API LLM, bot Telegram et service Gateway. Ce guide s'adresse aux développeurs et petites équipes qui veulent passer de « ça tourne en CLI » à « Telegram disponible à tout moment, hôte en ligne 7j/7 » sur macOS, Linux ou WSL2 : d'abord six idées reçues, puis tableau d'environnement et matrice d'hébergement, enfin des commandes reproductibles pour curl | bash, hermes doctor, hermes setup et le Telegram Gateway (huit étapes minimum). L'architecture mémoire et le TCO achat/location sont traités dans notre article mémoire à trois niveaux et l'analyse TCO sur 24 mois. Tarifs sur la page tarifs NOVAKVM, commande via page commander. Commandes et versions selon la documentation officielle — rouvrir les liens après chaque release.

[ SECTION_01 ] // PAIN_MAP Les six malentendus les plus fréquents lors de l'installation Hermes (2026)

• « Il faut installer Python 3.11 et Node 22 à la main » : le script officiel provisionne les runtimes via uv ; seul Git fonctionnel est requis. Mélanger le Python système provoque souvent ModuleNotFoundError.
• « Une fois installé, le bot répond dans Telegram » : le chat CLI et le Gateway sont des chemins distincts ; les canaux exigent hermes gateway setup et un daemon actif.
• « hermes: command not found signifie échec d'installation » : c'est le plus souvent un PATH non rechargé — nouveau terminal ou source ~/.zshrc, sans réinstallation complète.
• « Tout VPS Linux équivaut à un Mac » : la documentation est la plus complète sur macOS ; l'automatisation navigateur et certains Skills macOS se comportent différemment sur Linux pur — lire les notes plateforme avant la production.
• « Le bot ne répond pas en groupe malgré @mention » : en mode confidentialité Telegram, les groupes ne voient souvent que les commandes / ; désactiver Group Privacy dans BotFather et retirer puis réinviter le bot.
• « Un MacBook fermé suffit comme Gateway de production » : la veille suspend les processus ; la composition de Skills et les callbacks de canaux exigent un hôte always-on supervisé — bien au-delà d'une installation réussie.

Points d'entrée officiels Hermes — revérifier l'URL de l'installateur après chaque release :

Documentation officielle d'installation Hermes Agent (Nous Research)

NousResearch/hermes-agent (dépôt GitHub)

[ SECTION_02 ] // ENV_MATRIX Prérequis Hermes Agent : minimum et choix du support de déploiement

Le tableau résume des planchers pragmatiques pour une installation locale ; un Gateway n'utilisant que des API cloud consomme moins de RAM qu'un scénario avec Ollama local. Tarifs et stock : page tarifs.

Valider l'installation uniquement ? Un portable suffit. Pour que Telegram et la composition de Skills tournent des semaines, placez le Gateway sur un Mac de production sans veille.

[ SECTION_03 ] // INSTALL Installation one-liner Hermes Agent : script curl, PATH et hermes doctor

Sur macOS, Linux, WSL2 ou Termux, Nous Research recommande cette ligne (clone du dépôt vers ~/.hermes/hermes-agent/, commande globale hermes) :

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.zshrc
hermes doctor
hermes --version

Sur serveur headless sans automatisation navigateur, ignorer les dépendances browser (paramètres selon doc officielle) :

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash -s -- --skip-browser

hermes doctor vérifie Python, Node, ripgrep, ffmpeg, PATH et clés API ; en cas de ❌, suivre les indications sans contourner. L'installateur PowerShell natif Windows est en bêta précoce — pour la production, WSL2 plus les commandes Linux ci-dessus reste le chemin le plus sûr (voir chapitre Installation).

[ SECTION_04 ] // RUNBOOK Huit étapes : modèle, test CLI, Telegram et Gateway permanent

1. Finaliser l'installation et charger le PATH : répertoire ~/.hermes présent, puis hermes doctor sans blocage.
2. Configurer le LLM : débutants hermes setup ; clé existante via hermes model ou ~/.hermes/.env (OpenRouter, Anthropic, OpenAI, URL de base Ollama).
3. Test CLI : lancer hermes, tâche réelle (ex. distribution des types de fichiers du répertoire courant), vérifier outils et facturation API.
4. Créer le bot Telegram : @BotFather, /newbot, conserver le token ; ID numérique via @userinfobot.
5. Configuration Gateway : hermes gateway setup avec Telegram ; ou variables TELEGRAM_BOT_TOKEN et TELEGRAM_ALLOWED_USERS.
6. Valider le Gateway au premier plan : hermes gateway, message au bot en chat privé, confirmer la réponse avant passage en arrière-plan.
7. Installer le daemon : macOS hermes gateway install + hermes gateway start (launchd) ; Linux option sudo hermes gateway install --system, journaux via journalctl -u hermes-gateway -f.
8. Discipline de sauvegarde : archiver régulièrement ~/.hermes/ ; lors d'un changement d'hôte ou fin de location, restaurer l'arborescence — réinstaller seulement les binaires provoque une « amnésie ».

hermes gateway setup
hermes gateway install
hermes gateway start
hermes gateway status

Pour les groupes Telegram, lire la documentation Messaging sur le mode confidentialité ; après désactivation de Group Privacy, retirer le bot du groupe puis le réinviter.

Documentation Telegram Hermes Agent (GitHub)

[ SECTION_05 ] // TROUBLESHOOT Erreurs d'installation et de Gateway : matrice de diagnostic

Pour exécuter ces étapes sur un Mac distant, la baseline connexion et session est dans le centre d'aide. Pour un Apple Silicon dédié et une effacement prévisible en fin de contrat, privilégier la location bare metal mensuelle plutôt qu'un portable personnel en continu.

[ SECTION_06 ] // HARD_FACTS Informations techniques citables et conclusion NOVAKVM

• Comportement de l'installateur : le script officiel installe via uv Python 3.11, Node 22, ripgrep, ffmpeg et place le dépôt sous ~/.hermes/hermes-agent/. (Source : documentation Installation — revérifier après release.)
• Racine de configuration : variables d'environnement et tokens Gateway par défaut dans ~/.hermes/.env ; mémoire inter-sessions et Skills persistent dans le même arbre. (Source : documentation Memory / Setup.)
• Agnostique modèle : Hermes prend en charge Anthropic, OpenAI, OpenRouter, GitHub Copilot, Ollama, etc. ; IDs modèle et tarification chez chaque fournisseur.
• Extension MCP : déclarer mcp_servers dans ~/.hermes/config.yaml, OAuth via hermes mcp login (headless souvent avec tunnel SSH).
• Contrôle de version : se référer à hermes --version et aux GitHub Releases ; ne pas reprendre des chiffres d'étoiles ou classements de performance non sourcés.

« Installé » n'est qu'un début : les portables personnels conviennent au POC du week-end, mais veille, mises à jour système et mélange de données privées interrompent Gateway et composition de Skills. Un VPS Linux pur tient la route API, avec friction sur l'automatisation navigateur et la chaîne d'outils macOS. Si Hermes s'avère durable en CLI, la voie production la plus pragmatique est de louer d'abord un Mac mini M4 dédié au mois, consulter deux à quatre semaines de journaux Gateway, puis décider de l'achat matériel.

Sur la page tarifs NOVAKVM, choisir la classe selon parallélisme et disque ; provisionner via page commander, puis appliquer les huit étapes de cet article pour installation et Telegram permanent. Pour une production Hermes exigeant chemin d'installation macOS natif, Gateway launchd 7j/7 et effacement contractuel prévisible, la location bare metal Mac mini M4 NOVAKVM coûte généralement moins en décision que de maintenir un portable principal allumé en permanence.