Installer Hermes Agent en 2026 : une commande jusqu'à Telegram 24h/24
Hermes Agent est le framework d'agent IA auto-évolutif MIT de Nous Research en 2026, avec plus de 170 000 étoiles GitHub. Contrairement aux chatbots qui s'effacent à la fermeture de fenêtre, il s'appuie sur MEMORY.md, les répertoires Skill et Gateway pour transformer les tâches en capacité réutilisable — à condition de bien l'installer, configurer un modèle et faire tourner la passerelle Telegram en continu.
Cet article vise ceux qui veulent tout finir en une lecture : ① différences avec OpenClaw et LangGraph et points de blocage ; ② le parcours complet curl → hermes doctor → hermes setup → passerelle Telegram → launchd/systemd ; ③ matrice LLM, checklist en six étapes et tableau d'erreurs. Matériel et bench Pi : comparaison trois hôtes ; mémoire : guide mémoire persistante.
01 Avant d'installer Hermes Agent : engouement 2026 et trois vrais blocages
Hermes Agent a décollé après sa sortie de février 2026 grâce aux observations communautaires : Skills auto-écrits en fin de tâche, ~38 % de tokens en moins sur des jobs similaires. Face à OpenClaw (workflows multi-agents) ou LangGraph (machines à états), Hermes se distingue par mémoire native inter-sessions, passerelle 20+ messageries, MCP plug-and-play. Après l'étoile, trois étapes coincent souvent :
- Environnement fragmenté : croire qu'il faut préinstaller Python 3.11, Node 22, ripgrep, ffmpeg — le script officiel complète via
uv, mais sans recharger le PATH :hermes: command not found. - Pas de modèle : install OK mais
API key not set; le CLI s'ouvre sans inférence. - Passerelle non permanente : bot Telegram configuré, portable fermé, bot « mort », intérêts composés Skill et mémoire hebdomadaire coupés.
En une phrase : Hermes roule bien si install + modèle + passerelle toujours active forment un seul pipeline, pas trois essais séparés.
Ligne stable v0.15.1 (29.5.2026), corrige notamment les rechargements Dashboard en loopback de v0.15.0 (release). Commandes pour macOS / Linux / WSL2 ; PowerShell Windows : install.ps1 ; chat Dashboard : WSL2 conseillé.
02 Prérequis Hermes Agent et matrice fournisseurs LLM
Seul prérequis dur du script : Git (git --version). Python, Node, ripgrep, ffmpeg sont installés par le script, sans sudo.
| Élément | Minimum | Recommandé |
|---|---|---|
| OS | macOS 12+ / Ubuntu 20.04+ / WSL2 | macOS 14+ (Apple Silicon) / Ubuntu 24.04 LTS |
| RAM | 4 Go (Gateway + API seulement) | 16 Go+ (Ollama 8B local) |
| Disque | ~1,5 Go (cache Skills inclus) | 20 Go SSD+ (logs et poids modèles) |
| Réseau | GitHub raw + API LLM accessibles | Sortie stable faible latence (Telegram entrant) |
| Fournisseur | Pour qui | Configuration |
|---|---|---|
| Nous Portal | Essai rapide sans config | hermes setup --portal OAuth |
| OpenRouter | Multi-modèles, une clé | OPENROUTER_API_KEY dans ~/.hermes/.env |
| Anthropic / OpenAI | Prod Claude / GPT | Clé API ou OAuth (plan Max) |
| Ollama / VLLM | Inférence locale, confidentialité | URL de base + modèle ; 16 Go+ RAM |
Serveur headless (sans automation navigateur GUI) : ajouter --skip-browser. Config dans ~/.hermes/.env et ~/.hermes/config.yaml.
03 Install Hermes Agent en une ligne : six étapes du curl au premier chat
Sur macOS, Linux ou WSL2, exécuter le script officiel (aligné sur la doc d'installation) :
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
# headless VPS optional
# curl -fsSL ... | bash -s -- --skip-browser
source ~/.zshrc
hermes doctor
hermes --version
hermes setup
hermes
Le script installe uv → Python 3.11 → Node.js 22 → ripgrep / ffmpeg → clone dans ~/.hermes/hermes-agent/ → PATH → registre Skills. Succès : Hermes Agent installed at ~/.hermes dans le terminal.
- curl : Git disponible ; proxy entreprise :
https_proxyd'abord. - Recharger le shell :
source ~/.zshrcousource ~/.bashrc. - Santé :
hermes doctor(~12 points). - Version :
hermes --version≥ v0.14.x ; mise à jourhermes update. - Modèle :
hermes setupouhermes model→~/.hermes/.env. - Chat test :
hermes, compter les fichiers ou résumer l'actu IA.
Raccourci : curl -fsSL https://get.hermes-agent.org | bash. PowerShell : iex (irm .../install.ps1) ; Termux : script Linux.
04 Hermes Agent Telegram et passerelle Gateway 24h/24
Pour joindre l'agent depuis le téléphone : création du bot, config Gateway, service système.
- Bot :
@BotFather,/newbot, nom se terminant parbot, sauver le token. - ID utilisateur : message à
@userinfobotpour l'ID numérique (liste blanche). - Config interactive :
hermes gateway setup, Telegram, coller token et ID. - Ou .env manuel :
TELEGRAM_BOT_TOKEN=...,TELEGRAM_ALLOWED_USERS=votreID. - Test avant-plan :
hermes gateway, message depuis le téléphone. - Arrière-plan : macOS
hermes gateway install+start(launchd) ; Linuxsudo hermes gateway install --system, logsjournalctl -u hermes-gateway -f.
Groupes : mode confidentialité par défaut : seules les commandes /. Pour les groupes, désactiver Group Privacy dans BotFather et réinviter le bot. Discord / Slack : même hermes gateway setup (doc messagerie).
hermes gateway install
hermes gateway start
hermes gateway status
# Linux boot autostart (optional)
sudo hermes gateway install --system
sudo hermes gateway start --system
05 Hermes Agent : chiffres citables et erreurs d'installation
- GitHub (06/2026) : ~175 000 stars, MIT, 295+ contributeurs (dépôt).
- Taille : ~1,5 Go avec cache Skills ;
~/.hermes/croît souvent de 200–600 Mo en trois mois. - Intérêts composés Skill : Skills 3 → 19 en 30 jours, ~38 % de tokens en moins — hôte en ligne 24h/24 requis.
- RAM passerelle (macOS) : Gateway + SQLite seuls ~1,2–1,8 Go ; avec Ollama 8B prévoir 24 Go mémoire unifiée.
| Erreur / symptôme | Cause | Correctif |
|---|---|---|
hermes: command not found |
PATH non rechargé | source ~/.zshrc ou nouveau terminal |
API key not set |
Pas de LLM | hermes model ou ~/.hermes/.env |
| Config perdue après upgrade | Migration version | hermes config check && hermes config migrate |
| Bot muet en groupe | Privacy / pas réinvité | Désactiver Group Privacy, réinviter le bot |
Option : mcp_servers dans ~/.hermes/config.yaml ; sans GUI : hermes mcp login + tunnel SSH pour OAuth.
06 Où faire tourner Hermes : comparaison et conclusion JEXCLOUD
| Plateforme | Disponibilité 24h/24 | Maturité install | Phase |
|---|---|---|---|
| MacBook personnel | Arrêt à la fermeture | curl officiel le plus simple | POC / week-end |
| VPS Linux | Élevée, pas macOS | --skip-browser, chemins Skill différents |
Équipe DevOps |
| JEXCLOUD Mac Mini M4 | SLA datacenter, IPv4 dédiée | Mêmes commandes que Mac local | Prod Telegram + 8B local |
Lacunes laptop et VPS surbookés : ① connexions passerelle instables ; ② Skills automation navigateur macOS non reproductibles 1:1 sur Linux ; ③ sans RAM dédiée, OOM sur sous-agents parallèles malgré hermes doctor vert.
Plus sûr : louer un Mac Mini M4 bare metal chez JEXCLOUD au mois, SSH avec les mêmes commandes, launchd KeepAlive, ~/.hermes sur votre disque loué — pas de surallocation, Telegram entrant stable, rsync Skills et mémoire avant restitution. M4.S / M4.M / M4.XL : tarifs ; commande : commande et aide.