Installation curl · hermes doctor · modèle & gateway · matrice plateformes · runbook en six étapes
Vous souhaitez déployer Nous Research Hermes Agent en 2026 (environ 174 000 étoiles sur GitHub) mais bloquez sur le PATH, la clé API ou Telegram muet ? Ce guide professionnel couvre le parcours d'installation complet : curl | bash officiel installe Python 3.11 / Node 22, hermes doctor exécute 12 contrôles, hermes setup configure le modèle et le gateway jusqu'à Telegram 24 h/24. Inclus : prérequis, matrice de plateformes, runbook en six étapes, tableau d'erreurs — et pourquoi la location Mac Mini M4 convient le mieux à la production permanente.
Hermes Agent (Nous Research, MIT) figure parmi les agents IA open source auto-évolutifs les plus suivis en 2026 : après chaque type de tâche, des Skills réutilisables sont générés ; la communauté estime une baisse d'environ 38 % de tokens sur des tâches similaires. Le gateway connecte Telegram, Discord, Slack et 20+ plateformes ; MCP et backends Claude, OpenRouter, Ollama sont pris en charge. Par rapport à OpenClaw et LangGraph : mémoire persistante inter-session (SESSION → MEMORY.md → USER.md) et création native de Skills ; le script s'exécute sur un VPS à 5 $ ou un Mac — mais le 24 h/24 en production et les Skills navigateur macOS dépendent du choix d'hôte.
Pas de théorie : cinq points de friction à l'installation — hermes: command not found, clé API absente, dérive de configuration après mise à jour, groupes Telegram silencieux, portable qui interrompt le gateway à la fermeture. Pour l'architecture mémoire après installation : mémoire à trois niveaux et mesures 24 h/24.
| Paramètre | Minimum | Recommandé (gateway production) |
|---|---|---|
| Système | macOS 12+ / Ubuntu 20.04+ / WSL2 | macOS 14+ (Apple Silicon) ou Ubuntu 24.04 LTS |
| Python / Node | Script installe 3.11 / 22 | Pas d'installation manuelle — référence hermes doctor |
| Mémoire | 4 Go (gateway + API cloud uniquement) | 16 Go+ ; modèle local : 32 Go UMA |
| Disque | ~1,5 Go (cache Skills inclus) | 20 Go SSD+, marge FTS5 et journaux |
| Réseau | GitHub raw + API LLM accessibles | Latence stable pour webhooks IM |
Installer Python/Node d'abord : install.sh via uv installe Python 3.11, Node 22, ripgrep, ffmpeg — sans sudo.
Oublier de recharger le shell : PATH obsolète → command not found ; source ~/.zshrc ou nouveau terminal.
Ignorer hermes doctor : 12 contrôles détectent clé API, ffmpeg, PATH — souvent une heure gagnée.
Navigateur sur VPS headless : ajouter --skip-browser pour éviter l'échec Camoufox.
POC portable en production : veille MacBook = gateway coupé ; le compounding Skills exige un hôte dédié 24 h/24.
La même ligne curl | bash — l'écart porte sur disponibilité, I/O et chemin macOS natif. Installable ne signifie pas adapté au gateway et au compounding Skills 24 h/24. Matrice basée sur retours communauté et datacenter :
| Plateforme | Disponibilité 24 h/24 | Compounding Skills | Coût mensuel | Cas d'usage |
|---|---|---|---|---|
| MacBook personnel | ≈ 60 % (veille à la fermeture) | interruptions fréquentes | 0 € matériel + stress élevé | POC / CLI local uniquement |
| Raspberry Pi 4B 8 Go | ≈ 88 % | goulot I/O, timeouts longues tâches | achat unique | expérimentation, pas gateway prod |
| VPS x86 4 Go | ≈ 99,5 % | stable, sans Skills macOS | facturation à l'usage | API pure + Telegram, sans automation navigateur |
| Location Mac Mini M4 | SLA datacenter, ~100 % sur 30 jours | UMA + launchd, Skills cumulés | loyer mensuel fixe | Telegram 24 h/24 + Camoufox / Ollama local |
L'installation prend ~10 minutes ; le bon hôte 24 h/24 détermine si les Skills se composent ou repartent de zéro.
La mémoire unifiée M4 partage gateway (communauté : ~4,2 Go en continu), automation navigateur et SQLite WAL ; launchd sur macOS suit mieux le chemin de test officiel. Validation courte : louer 1 mois, mesurer Telegram et courbe Skills — voir retour 30 jours.
Étapes valables sur macOS / Linux / WSL2 ; VPS headless : --skip-browser à l'étape 1. Données sous ~/.hermes/ — sauvegarder avant mise à jour.
Installation en une commande : exécuter le script officiel, attendre l'installation, puis source ~/.zshrc (Linux : ~/.bashrc).
Contrôle santé : hermes doctor pour Python, Node, ripgrep, ffmpeg, PATH ; hermes --version ≥ v0.14.
Configurer le modèle : hermes setup ou hermes model ; OpenRouter / Anthropic / Nous Portal dans ~/.hermes/.env.
Test CLI : hermes en interactif, tâche avec appel d'outil (ex. compter les fichiers) — l'API doit répondre.
Telegram : créer le bot via BotFather → hermes gateway setup, choisir Telegram, token et TELEGRAM_ALLOWED_USERS ; groupes : désactiver la confidentialité, réinviter le bot.
Daemon 24 h/24 : hermes gateway install && hermes gateway start ; Linux : sudo hermes gateway install --system, macOS service utilisateur launchd.
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash source ~/.zshrc hermes doctor hermes setup hermes gateway setup hermes gateway install hermes gateway start hermes gateway status
Clé API manuelle : hermes config set OPENROUTER_API_KEY sk-or-xxxx ou dans ~/.hermes/.env. Après mise à jour, config manquante : hermes config check && hermes config migrate.
Ces symptômes apparaissent souvent quand le script a réussi mais le service est indisponible — traiter le tableau ligne par ligne ; ne pas modifier modèle, répertoire et gateway simultanément.
| Erreur / symptôme | Cause | Correction |
|---|---|---|
| hermes: command not found | PATH non rafraîchi | source ~/.zshrc ou nouveau terminal |
| API key not set | LLM non configuré | hermes model ou ~/.hermes/.env |
| Missing config after update | Dérive config après version | hermes config check && hermes config migrate |
| ModuleNotFoundError: dotenv | Python système au lieu du venv | utiliser ~/.hermes/hermes-agent/venv/bin/hermes |
| Groupe Telegram muet | Mode confidentialité bot | BotFather : Group Privacy off, retirer et réinviter le bot |
Hermes accepte tout MCP Server (GitHub, base de données, navigateur) via mcp_servers dans ~/.hermes/config.yaml ; OAuth headless : hermes mcp login + tunnel SSH. En production : stabiliser un canal avant d'empiler MCP.
Note : Windows via script PowerShell ; le terminal Dashboard /chat requiert WSL2 — WSL2 + chemin Linux aligné sur ce runbook.
~/.hermes/hermes-agent/.hermes doctor couvre ~12 points (Python 3.11, Node 22, ripgrep, ffmpeg, clé API, etc.).Portable et NAS domestique suffisent pour valider l'installation, mais affaiblissent Telegram 24 h/24 (veille, I/O VPS, absence de Skills navigateur macOS) ; le Pi peine avec 8B local et longues tâches. Pour une équipe qui traite Hermes comme un collègue permanent, la location Mac Mini M4 regroupe disponibilité, UMA et launchd en OpEx prévisible.
Runbook terminé et besoin d'un nœud 24 h/24 production : VpsMesh propose Mac Mini M4 en cloud — livraison SSH, panel ressources, sauvegarde de ~/.hermes/ avant fin de bail. Tarifs : tarifs Mac Mini M4, aide : centre d'aide, commande : page de commande.
Attention : ne pas changer d'hôte, mettre à jour Hermes en majeur et modifier la whitelist Telegram le même week-end — d'abord hermes gateway status stable 24 h, puis modèle ou MCP.
Non. install.sh installe via uv Python 3.11, Node.js 22, ripgrep et ffmpeg dans ~/.hermes/hermes-agent/. Puis source ~/.zshrc et hermes doctor — 12 contrôles.
En mode confidentialité, le bot ne répond qu'aux commandes /. BotFather → Bot Settings → Group Privacy désactivé, bot retiré et réinvité. TELEGRAM_ALLOWED_USERS doit contenir votre ID ; hermes gateway status doit être actif.
API cloud pure + Telegram : VPS x86 suffit. Skills navigateur macOS, Ollama local ou launchd : location Mac Mini M4 avec meilleure disponibilité et UMA. Test 1 mois — tarifs page tarifs, commande page commande.