2026 Hermes Agent : installation macOS / Linux / WSL2, Gateway Telegram et depannage 7j/7

Six pieges d'installation : pourquoi le seul README echoue souvent

Fin mai 2026, Nous Research a publie Hermes v0.15.2 avec pip install hermes-agent et l'installateur curl | bash. La popularite masque des frictions reelles la premiere heure sur une machine de production. Utilisez cette liste comme checklist avant de reinstaller ou d'ouvrir un ticket upstream.

1. PATH non recharge : le script ajoute hermes a ~/.zshrc ou ~/.bashrc. Sans source ni nouvel onglet terminal, hermes: command not found apparait alors que l'installation a reussi.
2. Python systeme vs venv : python3 -m hermes hors venv peut manquer dotenv. Point d'entree supporte : ~/.hermes/hermes-agent/venv/bin/hermes.
3. CLI sans modele : le shell interactif s'ouvre puis API key not set si hermes setup ou hermes model a ete ignore.
4. Gateway confondu avec le CLI : Telegram exige un processus long hermes gateway. Une session hermes ponctuelle ne bridge pas les messages vers le mobile.
5. Mode confidentialite des groupes Telegram : les bots ne repondent par defaut qu'aux commandes slash. Sans desactiver Group Privacy dans BotFather, l'operateur conclut a un bot defaillant.
6. Mise a niveau incomplete : de v0.14 a v0.15, les champs de configuration bougent. Executez hermes config check && hermes config migrate avant de diagnostiquer Missing config after update.

Contraste avec OpenClaw : OpenClaw excelle sur le Gateway multi-canaux et les deploiements npm ou Docker Compose. Hermes optimise MEMORY.md, USER.md, la capture de Skills apres tache et les outils MCP. Les deux coexistent sur un Mac avec des arbres separes ; cet article reste dans la voie installation. L'architecture et le hardware sont traites dans l'article memoire ; la courbe Skills sur 30 jours dans le retour d'experience 30 jours.

Pour une equipe, separez tot trois questions : l'OS de reference accepte-t-il l'installateur ? Le fournisseur LLM est-il valide par la securite ? Le Gateway peut-il rester en ligne la nuit et le week-end ? Ce runbook couvre les deux premieres en une session ; la troisieme motive les comparatifs d'hebergement MACCOME.

Les revues securite demandent souvent si Hermes « telephone » au-dela du LLM choisi. En pratique, le trafic sortant est domine par l'API modele, Telegram (long-polling ou webhook), les serveurs MCP configures et GitHub lors des mises a jour Skills. Documentez ces flux comme pour tout agent auto-heberge. Traitez ~/.hermes/.env comme des secrets de production.

Exigences d'environnement : ce qu'il faut reellement sur disque

L'installateur officiel provisionne Python 3.11 (via uv), Node.js 22, ripgrep et ffmpeg sur le chemin complet. Vous devez fournir git, HTTPS vers GitHub raw et votre fournisseur LLM. Sur Linux sans navigateur, passez --skip-browser pour eviter le poids Camoufox.

Un Mac distant se comporte comme un shell local : SSH, memes commandes, Gateway sous launchd ou systemd une fois valide. La latence vers la region API compte plus que la marque CPU pour les modeles cloud ; la memoire unifiee aide quand les Skills navigateur et plusieurs Gateways partagent la machine.

Sous WSL2, gardez ~/.hermes sur le filesystem Linux ext4, pas sur /mnt/c, pour des file watchers et SQLite WAL stables. Desactivez la veille Windows pendant les tests Gateway nocturnes. Si le proxy d'entreprise bloque raw GitHub, clonez le depot et lancez le script depuis un miroir interne, ou utilisez pip install hermes-agent via un registre PyPI miroir.

Runbook en huit etapes : d'une commande a Telegram en ligne

Etapes identiques sur macOS, Linux et WSL2. Validez chaque porte avant la suivante ; sauter hermes doctor coute generalement plus de temps que de l'executer.

1. Installation : script officiel (bloc bash ci-dessous). Succes : message du type Hermes Agent installed at ~/.hermes.
2. Recharger le shell : source ~/.zshrc ou source ~/.bashrc, ou nouvel onglet.
3. Sante : hermes doctor (environ douze controles). hermes --version doit afficher v0.15.x.
4. Modeles : hermes setup pour les debutants ; cles existantes via hermes model ou hermes config set OPENROUTER_API_KEY sk-or-xxxx dans ~/.hermes/.env.
5. Test fumee : hermes, demandez une tache legere (lister le repertoire courant) pour confirmer les outils.
6. Bot Telegram : @BotFather, /newbot, conservez le token ; @userinfobot pour l'ID numerique.
7. Gateway : hermes gateway setup et Telegram, ou variables TELEGRAM_BOT_TOKEN et TELEGRAM_ALLOWED_USERS.
8. Daemon : test avec hermes gateway ; production avec hermes gateway install && hermes gateway start (launchd ou systemd).

L'etape huit transforme « installe » en « production ». Un Gateway au premier plan meurt si SSH se coupe sans tmux ; les services utilisateur macOS survivent a la deconnexion si l'installation est correcte. Sur Linux serveur, --system avec sudo convient aux hotes que vous administrez.

Choisir un fournisseur LLM en 2026

Pour l'usage quotidien avec routage cloud, OpenRouter reste le chemin le plus rapide pour experimenter plusieurs modeles. Les equipes Claude standardisent sur Anthropic API ou OAuth. Essais zero-config : Nous Portal via hermes setup --portal. Confidentialite : Ollama via l'URL de base dans hermes model. v0.15 ajoute Grok et x_search — activez uniquement le necessaire dans hermes tools.

Telegram : ne commitez jamais les tokens ; regenerez dans BotFather si fuite. TELEGRAM_ALLOWED_USERS exige des ID numeriques, pas des @pseudo. Testez d'abord en DM avant les groupes pour isoler la confidentialite des groupes.

Metriques citeables : version, etoiles et capitalisation Skills

• Etoiles GitHub (juin 2026) : environ 174 720, licence MIT — confirmez le tag sur Releases (ligne stable v0.15.2 / 2026.5.29.2).
• Empreinte disque : environ 1,5 Go avec le registre Skills par defaut ; RSS Gateway souvent proche de 4,2 Go avec automatisation navigateur — plus fluide sur memoire unifiee Apple Silicon.
• Capitalisation Skills (terrain, article 30 jours) : Skills 3 a 19 en trente jours, environ 38 % de tokens en moins sur classes de taches repetees — seulement si l'hote reste en ligne 7j/7.

Les etoiles mesurent l'attention, pas votre disponibilite operationnelle. Suivez la taille disque, la RSS Gateway et l'accumulation des fichiers Skills pendant vos absences. Uptime Gateway sous 90 % le premier mois : traitez les economies de tokens comme hypothetiques.

Douze erreurs courantes et correctifs

Tableau de support premiere semaine. Si aucune ligne ne correspond, capturez hermes doctor et les logs Gateway avant un ticket GitHub.

Comparaison plateformes : portable, VPS et Mac Mini M4 loue

Reussir l'installation prouve que le binaire tourne. La production Telegram et la capitalisation Skills prouvent que l'hote reste disponible. Le tableau ci-dessous reprend le cadrage MACCOME lorsque les equipes demandent si un MacBook personnel « suffit » — souvent pour un POC d'apres-midi, rarement pour un mois de trafic Gateway.

Un MacBook convient aux etapes un a cinq de ce guide. Il devient inadapte quand l'etape huit doit survivre aux deplacements, a la veille et aux mises a jour OS sans intervention humaine. Un VPS x86 resout l'uptime mais peut manquer l'ergonomie macOS et le chemin Skill Camoufox deja valide sur Apple Silicon. La location Mac Mini M4 vise l'intersection : macOS reel, alimentation datacenter, launchd aligne avec cet article.

La finops compare souvent location et achat d'un Mini. Integrez electricite, IP fixe, risque physique et heures d'exploitation — pas seulement le prix catalogue. La location convertit le Capex en Opex reversible si l'experimentation s'arrete.

Conclusion : l'installation n'est qu'une etape ; l'uptime decide si l'agent coute moins cher

En suivant les huit etapes, la plupart des lecteurs obtiennent une premiere session CLI et une reponse Gateway Telegram en 30 a 60 minutes, sous reserve de cles API deja approuvees. Les echecs suivants sont surtout operationnels : veille du portable, rotation de token sans redemarrage Gateway, RAM insuffisante avec Skills navigateur.

Trois alternatives ont chacune une faiblesse claire. (a) Un portable ne reste pas fiablement en ligne 7j/7. (b) Un petit VPS x86 manque le chemin curl | bash macOS et le workflow Skill navigateur Camoufox. (c) Acheter son Mac Mini deplace Capex, fibre domestique et securite physique sur vous.

Si Hermes economise deja du travail repetitif et que vous voulez un cout mensuel previsible, une prise en main SSH en minutes et la possibilite d'archiver ~/.hermes/ avant changement d'hote, un noeud cloud Mac Mini M4 dedie MACCOME est en general la forme de production la plus propre : Apple Silicon reel, launchd natif, memes commandes que ce guide. Lisez l'article architecture, le retour 30 jours, puis choisissez une region sur la page tarifs location Mac Mini lorsque vous confiez l'uptime a l'agent plutot qu'a votre agenda de voyage.