macOS / Linux une ligne · hermes doctor · config LLM · Gateway 7×24 · validation Mac distant
Public : vous visez Hermes Agent de Nous Research (~170k étoiles GitHub, juin 2026) et voulez CLI, LLM et Telegram depuis le téléphone — mais PATH, clés API ou Gateway muet en groupe. En bref : curl | bash officiel, hermes doctor, LLM dans ~/.hermes/.env, hermes gateway install pour du 7×24 réel. Lisez pourquoi Hermes a besoin d'un Mac toujours allumé et louer un Mac Mini M4. Plan : prérequis → install → doctor/LLM → Telegram → Skills → erreurs → plateforme → FAQ.
Hermes Agent est l'agent « auto-évolutif » de Nous Research sous licence MIT : Après une tâche réussie, il distille la trajectoire en Skill sous ~/.hermes/skills/. Les benchmarks communautaires début 2026 rapportent environ 38 % de tokens en moins sur les workflows répétés (Beispiel: 3→19 Skills in 30 Tagen Daily Use). Un processus Gateway relie Telegram, Discord, Slack, WhatsApp et plus de vingt autres canaux; MCP-Server étendent les outils sans forker le dépôt principal.
Par rapport à OpenClaw (des playbooks IM plus riches sur ce site) oder CrewAI / LangGraph (frameworks d'orchestration à assembler soi-même) Hermes est un produit installable: CLI, Doctor-Checks, adaptateurs de canaux et fichiers mémoire (SESSION → MEMORY.md → USER.md). Wer unseren article mémoire trois couches et location Mac Mini a lu cet article, utilise ce guide comme complément pratique: installer, vérifier, garder le démon actif en permanence.
En juin 2026, trois sujets dominent les tickets: si l'installateur inclut vraiment Python et Node, si Gateway survit aux reboots via launchd/systemd, et ob der Telegram-mode confidentialité de groupe ignore les messages normaux. Nous suivons l'ordre réel des tickets — pas un copier-coller du README. Documentation officielle: hermes-agent.nousresearch.com/docs/getting-started/installation; Source de vérité des versions: github.com/NousResearch/hermes-agent.
Prérequis sous-estimés : Beaucoup pensent devoir installer Python 3.11, Node 22, ripgrep et ffmpeg à la main — le script le fait.
Pas de « cerveau » LLM : la CLI démarre mais l'inférence échoue car hermes setup oder ~/.hermes/.env manque.
Gateway seulement au premier plan : fermer SSH tue Telegram; hermes gateway install n'a jamais été exécuté.
Confidentialité de groupe : le bot ne répond aux /que aux commandes / jusqu'à désactivation de la confidentialité BotFather et réinvitation.
L'installateur sonde l'OS et installe les dépendances. Le tableau aide à juger si la machine suffit et si vous restez sur des API cloud ou des modèles locaux.
Chez les équipes francophones, l'erreur fréquente est, un VPS trop petit avec Ollama et l'automatisation navigateur — swap et long polling Telegram instable. Dimensionnez la RAM avant le premier hermes doctor, pas après la première panne de production.
| Élément | Minimum | Recommandé |
|---|---|---|
| OS | macOS 12+, Ubuntu 20.04+, WSL2 | macOS 14+ (Apple Silicon) / Ubuntu 24.04 LTS |
| Python / Node | Installer provides 3.11 / Node 18+ | Installer defaults to Node 22; no sudo required |
| RAM | 4 GB (Gateway + API cloud uniquement) | 16 GB (Ollama ou automatisation navigateur) |
| Disque | ~1,5 GB cache Skill inclus | 20 GB+ SSD pour poids de modèles locaux |
| Réseau | GitHub raw + API LLM accessibles | Liaison stable et basse latence pour le long polling Telegram |
À retenir : (1) Python, Node, ripgrep et ffmpeg ne sont pas requis manuellement pour une install standard. (2) VPS Linux sans GUI : --skip-browser. (3) Windows nativ ist Beta — WSL2 + Linux-Installer ist der sousstützte Weg.
Dans le terminal, lancez le script officiel de la branche main(revérifiez l'URL dans la doc Nous avant la production) :
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
Le script fait typiquement : uv → Python 3.11 → Node.js 22 → ripgrep et ffmpeg → Clone nach ~/.hermes/hermes-agent/ → commande globale hermes→ registre Skill par défaut. Succès : ✅ Hermes Agent installed at ~/.hermes dans la sortie de l'installateur.
source ~/.zshrc (macOS) oder source ~/.bashrc (Linux), pour que PATH voie le shim.
Sans GUI : curl -fsSL .../install.sh | bash -s -- --skip-browser.
hermes doctor — la checklist santé doit être verte (section 04).
hermes setup pour le fournisseur LLM (table section 04).
Auf einem Mac distant loué première installation en VNC si macOS demande capture d'écran ou accessibilité — SSH seul ne clique pas les dialogues TCC.
Windows: iex (irm .../install.ps1), Dateien sous %LOCALAPPDATA%\hermes\; WSL2 pour le terminal du tableau de bord si la doc exige un shell Unix. Termux auf Android utilise le même curl | bashavec détection d'environnement.
VNC-Login → Terminal → Installer → capture d'écran de hermes doctor pour le runbook → hermes setup pour les clés API → puis SSH au quotidien. Sous ~/.hermes/ se trouvent Skills, sessions SQLite et .env. Avant de rendre le matériel : tar czf hermes-backup.tgz ~/.hermes et restaurer sur le nœud suivant.
hermes doctor hermes --version hermes setup # assistant complet ; idéal au premier lancement # oder: hermes model
hermes doctor est votre porte d'acceptation : virtualenv, shim CLI, config, pile navigateur optionnelle et prérequis canaux. Un doctor vert équivaut à une CI — ne pas sauter avant d'envoyer le trafic Telegram sur la machine.
| Fournisseur | Atout | Configuration |
|---|---|---|
| Nous Portal | Abonnement ; 300+ modèles | hermes setup --portal (OAuth) |
| OpenRouter | Expériences multi-modèles | Clé API dans ~/.hermes/.env |
| Anthropic / OpenAI | Claude / GPT | Clé API ou OAuth via l'assistant |
| Ollama / vLLM | Inférence locale | URL de base + clé ; prévoir 16 Go+ de RAM |
Définir les clés explicitement : hermes config set OPENROUTER_API_KEY sk-or-xxxx ou dans ~/.hermes/.env. Test fumée avec hermes en interactif — par ex. « résume les titres IA du jour » et vérifier l'absence de 401 .
Deuxième rappel : Doctor avant install Gateway ; la version aide le support ; Ollama sur 8 Go swap en recherche Skill parallèle — RAM comme l'article mémoire : 16 GB plancher 16 Go / 24 Go confort.
Dans Telegram @BotFather ouvrez /newbot, et stockez le token du bot.
@userinfobot (oder gleichwertig) pour l'ID utilisateur numérique.
hermes gateway setup, Telegram wählen, token + ID — ou TELEGRAM_BOT_TOKEN et TELEGRAM_ALLOWED_USERS in .env.
Test avec hermes gateway im Vordergret; Bot per DM vom Handy.
Production : hermes gateway install && hermes gateway start. macOS: launchd; Linux: sudo hermes gateway install --system pour systemd.
Chats de groupe : Standard-Bots laufen im Privatsphäre-Modus et sehen nur Slash-Befehle. In BotFather Group Privacy deaktivieren, Bot aus der Gruppe entfernen et erneut einladen — sonst debuggen Sie die falsche Schicht.
Acceptation 15 minutes : (1) réponse DM OK. (2) hermes gateway status = running. (3) Auto-démarrage après reboot. (4) Pas de 401 (clé) ou 429 (quota). Linux : journalctl -u hermes-gateway -f; Mac loué : Console en VNC filtrée sur hermes .
| Commande | Rôle |
|---|---|
| hermes | CLI de chat interactive |
| hermes tools | Activer/désactiver les outils |
| hermes gateway status | Daemon-Gesetheit |
| hermes update | Dernière version |
| hermes config check | Vérifier la config après upgrade |
Évolution Skill ne compose que sur des machines toujours en ligne : erfolgreiche Läufe werden zu Markdown-Prozeduren sous ~/.hermes/skills/. Mettre le MacBook en veille chaque nuit stoppe l'effet compound — même si les fichiers restent sur le disque.
Serveurs MCP dans ~/.hermes/config.yaml sous mcp_servers (ex. GitHub). Jetons à privilèges minimaux. Browser-MCP ist auf macOS am vollständigsten; headless Linux fehlen oft Abhängigkeiten — ein Gret, Gateway nach der POC-Phase auf einen Mac Mini zu verlagern.
| Symptôme | Cause probable | Correctif |
|---|---|---|
| hermes: command not foet | PATH non rafraîchi | source ~/.zshrc oder nouveau terminal |
| API key not set | LLM non configuré | hermes model oder .env |
| Missing config after update | dérive de schéma | hermes config migrate |
| ModuleNotFoetError: dotenv | Mauvais Python | ~/.hermes/.../venv/bin/hermes |
| Groupe Telegram silencieux | Privatsphäre-Modus | BotFather off + réinviter le bot |
| Plateforme | Disponibilité 7×24 | Compound Skill | Idéal pour |
|---|---|---|---|
| MacBook personnel | ~60 % (veille tue Gateway) | Interrompu | POC week-end seulement |
| x86-VPS (4 GB) | ~99,5 % Uptime | Stabil, keine macOS-only Tools | Opérateurs Linux uniquement |
| Location Mac Mini M4 | SLA datacenter | launchd + Unified Memory | Production Telegram |
Ein neuer Mac Mini M4 mit 16 GB kostet in der EU oft ret 650–750 € (juin 2026 — vérifiez avant budget). Über 24 Monate amortisiert das etwa 27–31 €/Monat plus Strom, Kühlung et Ausfallrisiko in eigener Verantwortung. VNCMac-Monatsmiete wandelt CapEx in OpEx, während Sie prüfen, ob Hermes wirklich zwei Steten pro Tag spart. Unified Memory hält Gateway (~4,2 GB in typischen Traces), Browser-CDP et SQLite-WAL in einem Pool — 4-GB-x86-VPS swappen oft bei Skill-FTS-Wartung.
Troisième chiffre pour les slides : ~170k étoiles GitHub (juin 2026), ~38 % de tokens en moins sur tâches répétées dans les benchmarks Skill, 12+ checks doctor avant prod, acceptation Telegram 15 minutes.
Non. Le install.sh installiert per uv Python 3.11, Node 22, ripgrep et ffmpeg et registriert die hermes.
Die meisten Install- et Gateway-Schritte gehen per SSH. Erstmalige macOS-Datenschutz-Dialoge et manche OAuth-Browser-Callbacks brauchen VNC — wie in unseren OpenClaw-Remote-Mac-Leitfäden.
Le point d'entrée reste le script officiel. Mise à jour avec hermes update; en cas de dérive de config hermes config check && hermes config migrate.
L'article mémoire erklärt, warum 7×24-Disk für SOUL, Skills et SQLite zählt. Dieser Leitfaden deckt Installation et Kanäle ab. Erst installieren, dann Host-Stufe wählen.
Ja, mit getrennten Verzeichnissen et Ports. RAM entsprechend budgetieren — Isolation siehe Multi-Agent auf einem gemieteten Mini.
Hermes installieren ist absichtlich langweilig: ein offizielles Skript, ein hermes doctor, eine .env, ein Gateway-Dienst. Zwischen Demo et Produktion liegt Uptime — Skills compoeten, Telegram bleibt erreichbar, Memory-Dateien schreiben nur, solange Maschine et Daemon laufen.
Un laptop en veille, un Wi‑Fi domestique instable ou un VPS à 5 $ bridé au pic transforment « plus intelligent avec le temps » en « nouvel employé chaque lundi ». Acheter un Mac Mini M4 vaut le coup une fois la charge annuelle mesurée. Tant que vous prouvez la valeur, louez un M4 physique, installez Hermes en SSH, permissions en VNC, ~/.hermes/ tarball avant fin de bail.
Avoir installé Hermes est l'étape un ; le faire tourner est le produit. forfaits mensuels Mac Mini M4 — un hôte qui ne part pas à 18 h.