Installer Hermes Agent sur un Mac mini

Ce qu’est Hermes Agent

Hermes Agent est un agent open source de Nous Research, sous licence MIT. Il garde une mémoire entre les sessions et écrit ses propres skills à mesure qu’il apprend votre travail. Un gateway le relie à Telegram, Discord, WhatsApp et d’autres apps de messagerie (github.com/NousResearch/hermes-agent, octobre 2026).

Vous pouvez l’utiliser comme un chat dans le terminal, comme d’autres agents de code. Ou vous pouvez laisser tourner le gateway et lui écrire depuis votre téléphone. C’est pour ce second usage qu’on le veut sur un Mac toujours allumé.

Prérequis

• Apple silicon. La documentation d’installation indique que l’installeur macOS ne gère qu’Apple silicon, et que les Mac Intel ne sont pas pris en charge (octobre 2026).
• Python 3.11 à 3.14, git et curl. L’installeur prépare ses propres Python, Node, ffmpeg et ripgrep, donc un Mac vierge convient.
• Un modèle. Hermes fonctionne avec Anthropic, OpenAI, OpenRouter, Nous Portal et beaucoup d’autres. Sa documentation des fournisseurs cite des clés API, la connexion par navigateur et certains abonnements. Il accepte aussi tout endpoint local compatible OpenAI, comme Ollama.

L’installer

Voici la commande documentée pour macOS. Rechargez votre shell ensuite.

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.zshrc

Pour un script ou un shell distant, l’installeur accepte des options qui sautent les questions et les outils optionnels de navigateur et de computer use. Nous les avons utilisées pour notre test.

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --non-interactive --skip-browser --skip-computer-use

Nous l’avons lancé deux fois sur des machines macOS 26 hébergées par GitHub, le 2 octobre 2026. Cela a pris environ 2 minutes une fois et 6,5 minutes l’autre fois, surtout en téléchargements. La vérification de version a affiché ceci.

$ hermes --version
Hermes Agent v0.21.5+5635.g5bba024 (2026.9.24) · upstream 5bba024d

Il est utile de savoir ce qui a été installé et où. L’installeur a cloné le code dans un dossier hermes de votre dossier personnel. Il a placé ses propres copies de Python 3.14.7, Node, ffmpeg et ripgrep dans un dossier tools à l’intérieur. La commande hermes est allée dans le dossier bin local de votre dossier personnel. Il a aussi ajouté 58 skills fournis, dont certains pour Apple Notes, Rappels et iMessage. Ce sont de bonnes raisons de faire tourner Hermes sur un Mac plutôt que sur une machine Linux.

Choisissez maintenant un modèle et lancez l’assistant de configuration.

hermes model
hermes setup
hermes doctor

Vous venez d’OpenClaw ? Le README cite une commande qui importe vos réglages OpenClaw.

hermes claw migrate

Faire tourner le gateway 24/7

Connectez d’abord vos apps de messagerie. Installez ensuite le gateway comme service. Sur macOS, c’est un agent launchd.

hermes gateway setup
hermes gateway install
hermes gateway start
hermes gateway status
tail -f ~/.hermes/logs/gateway.log

Nous avons lancé la commande d’installation sur une machine de test sans aucune app de messagerie configurée. Son utilisateur s’appelle runner. La vérification du statut a confirmé que launchd faisait tourner le gateway.

$ hermes gateway install
Installing launchd service to: /Users/runner/Library/LaunchAgents/ai.hermes.gateway.plist
✓ Service installed and loaded!
$ hermes gateway status
✓ Service definition matches the current Hermes install
✓ Gateway is supervised by launchd (PID 14390)
  Auto-start at login and auto-restart on crash are available.

Le fichier de service est réglé pour se lancer au chargement, donc il revient à chaque ouverture de session. Il relance aussi le gateway s’il se termine sur une erreur. Un piège, signalé dans la documentation de messagerie. Si vous installez de nouveaux outils plus tard, relancez la commande d’installation pour que le service prenne en compte le nouveau PATH.

Comme tout LaunchAgent, il a besoin d’un utilisateur connecté. Activez l’ouverture de session automatique, puis désactivez la veille.

sudo pmset -a sleep 0
sudo pmset -a disksleep 0
sudo pmset -a displaysleep 10

Pour une session de terminal qui survit à une connexion coupée, lancez l’agent interactif dans tmux. Les étapes sont dans notre guide tmux. Elles fonctionnent de la même façon pour Hermes.

Notes de sécurité

• Le gateway refuse tout le monde tant que vous n’avez pas autorisé quelqu’un. Définissez une liste d’ID utilisateurs autorisés, ou approuvez les personnes une par une avec des codes d’appairage. Les codes expirent au bout d’une heure.
• Les approbations ont trois modes : manual, smart et off. Off équivaut à l’option yolo. Restez en manual tant que vous n’avez pas confiance dans votre configuration.
• Gardez les clés API dans le fichier env du dossier hermes, lisible par vous seul. Ne le commitez jamais.
• Pour plus d’isolation, la documentation de sécurité montre comment exécuter les commandes dans un conteneur Docker plutôt que sur le Mac lui-même.

# in ~/.hermes/.env
TELEGRAM_ALLOWED_USERS=123456789

# or approve one person by pairing code
hermes pairing approve telegram XKGH5N7P
chmod 600 ~/.hermes/.env

Selon la documentation, certaines protections tiennent même en mode yolo. Une liste de blocage stricte arrête des commandes comme la suppression récursive de tout le disque. Ses outils de fichiers refusent d’écrire dans les dossiers ssh et aws.

Le faire tourner sur un Mac MacRun

Notre offre Agent vous donne un Mac mini dédié avec la veille désactivée. Sa session revient toute seule après un redémarrage. Claude Code et Codex sont préinstallés. Hermes ne l’est pas. Vous l’installez avec le script ci-dessus, grâce à vos droits administrateur. Si Hermes utilise un modèle dans le cloud, le M6 de base avec 16 Go suffit largement.

Qui ne devrait pas louer un Mac pour cela. Hermes tourne aussi sous Linux. Si vous n’avez pas besoin de Xcode, d’Apple Notes ni d’iMessage, un serveur Linux coûte moins cher. Et MacRun sert au travail de développement. Utilisez-le pour le code, les builds et l’entretien des dépôts, pas comme assistant de vie personnelle.

Voyez ce que comprend l’offre Agent sur la page du Mac pour agents.