2026 Guide installation Hermes Agent : de curl en une ligne au Gateway Telegram 7j/7 sur macOS, Linux et Mac cloud (2026)

1. Public de ce guide d installation

Si vous avez lu notre article sur la memoire a trois couches, vous savez pourquoi Hermes exige un hote toujours actif. Cette page explique le comment : les commandes du depot Hermes Agent de Nous Research jusqu a un pont Telegram fonctionnel. Vous installez avec le script officiel, lancez hermes doctor jusqu a ce que les avertissements disparaissent, terminez hermes setup, fixez les modeles avec hermes model, creez un bot via BotFather, puis hermes gateway setup et hermes gateway install pour que les messages arrivent pendant votre sommeil. macOS (launchd), VPS Linux (systemd) et noeuds Mac cloud en SSH sont couverts, sans exiger un Mac mini en propre. Pour le TCO apres installation, voir la comparaison Pi vs VPS vs Mac mini.

L ordre est volontairement lineaire : chaque etape produit un resultat visible (version, doctor vert, premiere reponse CLI, reponse Telegram, service apres reboot). Vous evitez ainsi de tout configurer d un coup et de ne pas savoir si le modele, le Gateway ou l hote est en cause.

2. Points de friction avant curl

1. Installation OK, Gateway non. Cles API manquantes, mauvais terminal.backend ou conflits de port avec d autres agents : Telegram reste muet alors que hermes --version fonctionne.
2. Jeton Telegram sur portable en veille. BotFather delivre un jeton en trente secondes ; le long polling ou les webhooks exigent un processus qui ne suspend jamais — MacBook du quotidien et WSL2 le violent chaque jour.
3. VPS Linux qui tourne mais decale les workflows macOS. Hermes supporte sept backends terminal et plus de 20 canaux sur Linux, mais les Skills Xcode, Keychain ou notifications Apple poussent vers macOS natif ou un Mac loue.

Beaucoup d equipes passent une demi-journee a deboguer alors que l installateur etait vert — Gateway, routage de modeles et residence 24/7 sont trois problemes distincts. Ce guide les separe en etapes mesurables avec tests d acceptation.

3. Comparaison : MacBook vs Pi vs VPS vs location Mac mini

Le tableau choisit ou executer le runbook ci-dessous — pas si Hermes vaut le coup. La plupart des ponts Telegram de production reposent sur un VPS Linux dedie avec systemd ou un Mac mini M4 loue, tous deux en ligne sans mobiliser le portable de trajet.

4. Specs de reference (2026)

Chiffres utiles pour justifier le materiel :

• Couverture installateur : install.sh officiel pour macOS, Linux et WSL2 ; un processus Gateway peut attacher plus de 20 canaux de messagerie selon la doc Nous.
• Surface modeles : OpenRouter expose 300+ modeles ; routes Ollama / LM Studio locales si la RAM le permet — prevoyez 16 Go minimum sur Apple Silicon pour du 8B–13B plus overhead Gateway.
• Backends terminal : sept modes documentes — la plupart des utilisateurs Telegram-only restent sur local jusqu aux outils sandbox.

Pour accumuler des Skills, sauvegardez ~/.hermes chiffre : les documents Skill survivent au reboot, pas le contexte de session en RAM.

5. Runbook d installation en sept etapes

Etape 1 — Choisir l hote et les paquets de base

Sur macOS, installer les Xcode Command Line Tools (xcode-select --install). Sur VPS Ubuntu/Debian, curl, git, build-essential. Creer un utilisateur Unix hermes sans cles de signature production. Verifier HTTPS sortant et, pour webhooks Telegram, IP publique stable ou tunnel inverse.

Etape 2 — Installation en une ligne upstream

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
exec $SHELL
hermes --version

Rouvrir le shell pour le PATH. Sur un Mac cloud loue, installez en SSH comme en local — pas d edition cloud separee.

Etape 3 — Doctor puis setup interactif

hermes doctor
hermes doctor --fix   # verifier les diffs avant acceptation
hermes setup

hermes doctor detecte binaires Node manquants, cles API non definies et conflits de port Gateway. hermes setup parcourt les chemins sous ~/.hermes. Preferer les variables d environnement aux secrets en clair.

Etape 4 — Fixer les modeles

hermes model list
hermes model set default openrouter/anthropic/claude-sonnet-4
hermes config set inference.ollama.base_url http://127.0.0.1:11434

Un modele rapide pour la classification, un modele lourd pour le raisonnement multi-etapes. Mix local + cloud garde Telegram reactif sans facture API explosive.

Etape 5 — Telegram via BotFather

Dans Telegram, ouvrir @BotFather, /newbot, copier le jeton API HTTP, restreindre les chats autorises. Stocker le jeton puis exporter :

export TELEGRAM_BOT_TOKEN="123456:ABC..."
hermes gateway setup

Suivre les invites d appairage. Le mode webhook exige une terminaison HTTPS ; le long polling exige toujours un processus permanent.

Etape 6 — Installer le service Gateway

hermes gateway install
hermes gateway status

Sous macOS, LaunchAgent typique ; sous Linux, unite utilisateur systemd. Verifier le nom du service avant de quitter SSH.

Etape 7 — Tests de validation

hermes gateway restart
hermes cron add "0 7 * * *" "Send heartbeat: Gateway alive"

Rebooter l hote une fois. Si Telegram repond et le cron tire, vous avez un vrai 7j/7. Sauvegarder ~/.hermes chiffre avant mise a jour OS.

6. launchd vs systemd pour Gateway 7j/7

macOS (launchd) : LaunchAgent dans ~/Library/LaunchAgents/ avec KeepAlive et logs sous ~/Library/Logs/hermes/. Apres modification de config :

launchctl kickstart -k gui/$(id -u)/com.nousresearch.hermes.gateway
launchctl print gui/$(id -u)/com.nousresearch.hermes.gateway | grep state

Linux (systemd) : activer linger pour hermes (loginctl enable-linger hermes), puis systemctl --user enable --now hermes-gateway.service. Verifier avec systemctl --user status hermes-gateway. systemd est excellent sur VPS ; Keychain et notifications Apple necessitent souvent un noeud Mac en parallele.

7. Tableau d erreurs

8. FAQ

Installer sur WSL2 ? Oui pour experimenter ; la veille Windows casse Telegram 7j/7 sauf si le Gateway tourne ailleurs. Le reboot efface-t-il les Skills ? Les documents Skill sur disque restent ; le contexte RAM part — sauvegarder ~/.hermes avant migration. Telegram obligatoire ? Non — hermes gateway setup couvre aussi Slack et Discord ; Telegram reste le smoke test le plus rapide.

9. Conclusion

Un MacBook suffit pour les etapes 1–5 un apres-midi, mais fermeture du capot et FAI domestique en font un mauvais hote Telegram long terme. Le Pi economise mais manque de RAM. Un VPS a cinq dollars reste en ligne mais ajoute la friction systemd et pas d outillage macOS natif. Apres curl | bash, doctor vert et BotFather, le schema durable est hermes gateway install sur materiel qui ne suspend jamais — pour la plupart des lecteurs, launchd sur Mac mini M4, achete ou loue.

Louer un Mac Apple Silicon VPSMAC regroupe un budget mensuel previsible, SSH, Screen Sharing optionnel et effacement au retour. Memes commandes qu un mini de bureau ; seul le shell change de lieu. C est le chemin le plus court du curl en une ligne a un agent Telegram eveille a 3 h du matin — sans lier votre portable quotidien a l uptime Gateway.