2026 Installation Hermes Agent
macOS, Linux VPS, gateway Telegram et checklist production 7×24

Nous Research a open-sourcé Hermes Agent en février 2026 : un agent à mémoire persistante sur votre propre matériel. Ce guide est purement opérationnel — choisir l'hôte, lancer l'installateur curl officiel sur get.hermes-agent.org, configurer les modèles avec hermes setup, valider via hermes doctor, brancher Telegram avec hermes gateway, puis durcir pour un service continu. L'essai sur l'architecture mémoire en trois couches et le rapport de terrain à 30 jours sont dans les articles liés ; ici, les commandes qui mènent de zéro à un agent joignable depuis le téléphone en une session.

Installation Hermes Agent sur macOS et Linux avec gateway Telegram

Hermes Agent (Nous Research, MIT) s'installe en une commande : curl -fsSL https://get.hermes-agent.org | bash. Tout ce que l'agent apprend vit dans ~/.hermes/ sur la machine choisie. C'est simple jusqu'au moment où Telegram doit répondre à 2 h du matin pendant que le MacBook dort, ou où un reboot VPS laisse le gateway arrêté. Cet article complète notre guide hôte 7×24 et mémoire et le bilan 30 jours Skills : même agent, autre angle. Vous y trouvez la matrice hôte, les différences macOS/Linux, l'assistant setup, les checks doctor, l'autostart gateway et un runbook en sept étapes. FAQ location : guide location Mac au jour ; tarifs : guide tarifs M4 et tarifs bare-metal.

SOMMAIRE

  1. 01 Prérequis : matrice hôte, réseau, secrets
  2. 02 Installation : curl sur macOS et VPS Linux
  3. 03 Configurer le LLM : hermes setup et clés API
  4. 04 Validation : hermes doctor et pannes courantes
  5. 05 Gateway Telegram : canaux et hermes gateway
  6. 06 Runbook en sept étapes pour le 7×24
  7. 07 Trois données d'install et conversion MacDate

01. Prérequis : matrice hôte, réseau et secrets

Hermes n'est pas un SaaS hébergé. Vous fournissez CPU, disque, réseau sortant et identifiants LLM. Avant le curl, décidez quelle machine reste en ligne quand vous n'êtes pas au clavier.

Option hôte Chemin d'install Idéal pour Points de vigilance
MacBook (dev seulement) curl natif macOS Tests le jour même, CLI Veille coupe le gateway — pas de Telegram 7×24
VPS Linux (2 vCPU / 4 Go+) curl + systemd IP publique économique, egress datacenter Disques éphémères sans backup effacent ~/.hermes/
Mac mini M4 (propriété) get.hermes-agent.org natif 7×24 long terme, Ollama local optionnel Uplink domicile ; Tailscale pour SSH admin
Location Mac mini M4 MacDate Même installateur macOS Prouver Telegram + mémoire avant achat Effacement NIST à la libération — sauver ~/.hermes/
  • Clé fournisseur LLM — OpenAI, Anthropic, OpenRouter ; saisie dans hermes setup.
  • Token bot Telegram — via @BotFather ; egress HTTPS vers api.telegram.org.
  • SSH — pour VPS ou nœud MacDate selon la FAQ location.
  • Disque — au moins 10 Go libres pour state.db et skills.

Pré-vol : curl -fsSLI https://get.hermes-agent.org et curl -fsSLI https://api.telegram.org sans erreur de certificat.

Angle : Le guide mémoire explique pourquoi le 7×24 compte pour la boucle d'apprentissage. Ici, on suppose que vous voulez l'accessibilité — et on donne les commandes.

02. Installation : pipeline curl sur macOS et VPS Linux

L'entrée supportée est l'installateur officiel sur get.hermes-agent.org. Il détecte macOS/Linux, place hermes dans le PATH et initialise ~/.hermes/. Pas de Docker requis pour CLI + gateway standard.

macOS (natif, Mac mini M4 inclus)

# Installateur officiel (macOS) $ curl -fsSL https://get.hermes-agent.org | bash $ which hermes $ hermes --version

VPS Linux (Ubuntu 22.04 / Debian 12)

# VPS Linux — même installateur $ curl -fsSL https://get.hermes-agent.org | bash $ hermes --version

Sécurité : n'installez que depuis le domaine officiel. Si pipe-to-bash est interdit : télécharger, auditer, exécuter localement.

03. Configurer le LLM : hermes setup, clés API et modèle par défaut

L'install pose les binaires ; hermes setup configure le fournisseur, stocke les clés sous ~/.hermes/ et règle les défauts d'outils. Lancez-le juste après curl.

$ hermes setup $ hermes chat "Réponds exactement : setup-ok"

Une ligne de réponse valide clés, ID modèle et HTTPS vers le provider. Corrigez 401/limites avant le gateway Telegram.

Option : Ollama sur Mac mini M4

API cloud = chemin prod le plus rapide ; Ollama en local pour l'expérimentation privacy — même hermes setup, autre URL de base.

04. Validation : hermes doctor, memory status et catalogue d'erreurs

$ hermes doctor $ hermes memory status

Doctor vérifie : CLI, config, credentials, dépendances gateway, intégrité state.db, sous-système canaux. Erreurs fréquentes :

  • Auth provider échouée — relancer hermes setup ou rotater la clé.
  • Permission denied sur ~/.hermes/ — backup restauré en root ; corriger chown.
  • state.db corrompue — restore du tarball d'hier.
  • Port gateway occupé — hermes gateway stop puis redémarrage propre.
  • Hindsight sur Apple Silicon — #7135, embeddings CPU.

05. Gateway Telegram : canaux, hermes gateway et joignabilité

  1. @BotFather, /newbot, copier le token.
  2. Exporter TELEGRAM_BOT_TOKEN ou config canal sécurisée.
  3. Allowlist de votre ID utilisateur — pas d'inconnus sur l'agent.
$ hermes channels add telegram --token "$TELEGRAM_BOT_TOKEN" $ hermes gateway start $ hermes gateway status

Test depuis le mobile. Le long-polling Telegram part en sortie — pas besoin d'ouvrir un port entrant ; sécurisez quand même l'SSH admin.

Garder le gateway 7×24

  • macOS — LaunchAgent après login/reboot.
  • Linux — unité systemd user/system après premier start manuel réussi.

Test reboot : redémarrer l'hôte, attendre trois minutes, message au bot. Silence = autostart manquant.

06. Runbook en sept étapes pour le 7×24

Consolidé pour locataires MacDate et self-hosters. Comptez 75–90 minutes avec Telegram et test reboot.

  1. Provisionner l'hôte. Louer Mac mini M4 MacDate ou SSH VPS. FAQ location. Egress HTTPS et >10 Go disque.
  2. curl install. curl -fsSL https://get.hermes-agent.org | bash, puis hermes --version.
  3. hermes setup. Assistant, provider, modèle, smoke test hermes chat.
  4. hermes doctor. Corriger chaque ligne rouge ; hermes memory status si migration.
  5. Telegram. BotFather, hermes channels add telegram, ping mobile.
  6. Gateway permanent. hermes gateway start, autostart launchd/systemd, test reboot.
  7. Routine backup. tar czf hermes-backup-$(date +%F).tar.gz ~/.hermes/ hors boîte ; avant libération MacDate, télécharger l'archive.
# Chemin complet (macOS ou Linux) $ curl -fsSL https://get.hermes-agent.org | bash $ hermes setup $ hermes doctor $ hermes channels add telegram --token "$TELEGRAM_BOT_TOKEN" $ hermes gateway start $ tar czf ~/hermes-backup-$(date +%F).tar.gz ~/.hermes/

Articles liés : mémoire & TCO ; 30 jours Skills.

07. Trois données d'install et conversion MacDate

  • URL installateur canonique — get.hermes-agent.org suit les releases ; GitHub pour les issues.
  • Setup avant gateway — l'ordre réduit le support « bot en ligne, modèle en erreur ».
  • Doctor après chaque restore — migrations VPS sans doctor = permissions state.db cassées (voir retour terrain).

Conversion MacDate

Pas encore de Mac mini sur le bureau ? La location bare-metal MacDate offre le même curl | bash, la bande passante datacenter pour Telegram et un ~/.hermes/ isolé. Facturation au jour, deux semaines d'uptime gateway, puis comparer achat vs extension via le guide tarifs et les tarifs bare-metal. MacDate loue du matériel Apple — sans lien avec Nous Research.

Pour aller plus loin