Comment héberger soi-même l'Agent Hermes sur un VPS (Configuration 2026)

L’Agent Hermes fait beaucoup de revendications inhabituelles pour un projet open-source : il se souvient de tout, il écrit ses propres compétences, il s’améliore vraiment tout seul. Après trois semaines d’utilisation sur un Hetzner CCX13, ces affirmations se vérifient. Voici la méthode d’installation qui fonctionne réellement en 2026, avec les subtilités que la documentation officielle survole.

Ce qu’il vous faut avant de commencer

• Un VPS avec Ubuntu 24.04 ou Debian 12 (Hermes supporte aussi macOS et WSL2, ce guide est uniquement Linux)
• Accès SSH avec sudo ou root
• Minimum 4 Go de RAM si vous apportez votre propre modèle, 16 Go si vous hébergez le LLM vous-même
• 80 Go d’espace disque, de préférence NVMe
• Un point d’accès au modèle (clé API OpenAI, clé API Anthropic, ou une installation Ollama locale)

La configuration du VPS dépend de si vous hébergez le modèle vous-même. Consultez le meilleur VPS pour Hermes Agent pour la sélection réaliste. Pour ce tutoriel, je pars du principe que vous utilisez votre propre modèle, ce que font 80 % des utilisateurs.

Étape 1 : Provisionner le VPS

SSH vers un Hetzner CCX13 neuf ou équivalent et mettez à jour l’index des paquets :

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git ufw

Configurez un pare-feu simple avant d’exposer quoi que ce soit à Internet :

sudo ufw allow ssh
sudo ufw allow 443/tcp
sudo ufw enable

Ignorez le port 80 sauf si vous prévoyez de faire fonctionner une interface web publique. Les passerelles de messagerie (Telegram, Slack, Discord) utilisent toutes des connexions sortantes et n’ont pas besoin de ports entrants ouverts.

Étape 2 : Exécuter le script d’installation de Hermes

La ligne officielle en un seul coup de curl depuis le repo de Nous Research :

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

Lancez-le avec votre utilisateur de connexion habituel, jamais en root. C’est un installeur au niveau utilisateur, et voici ce qu’il fait réellement :

1. Installe uv, le gestionnaire de paquets Python d’Astral, et un Python 3.11 géré
2. Récupère Node.js, ripgrep et ffmpeg, dont dépend la couche outils
3. Décompresse Hermes dans ~/.hermes et ajoute le binaire hermes au PATH

Rien n’atterrit dans /opt, aucun utilisateur système n’est créé et aucun service n’est enregistré. Ce dernier point compte sur un VPS et nous le corrigeons à l’étape 6.

Rechargez votre shell pour que le nouveau PATH prenne effet :

source ~/.bashrc

Étape 3 : Choisir un fournisseur de modèle

Lancez l’assistant de configuration :

hermes setup

Il vous guide sur le fournisseur de modèle et les outils à activer. Apportez votre clé OpenAI, Anthropic ou OpenRouter, cette dernière étant le choix pragmatique sur un VPS puisqu’une seule clé donne accès à plus de 200 modèles, dont des modèles à poids ouverts. Si vous préférez ne pas jongler avec des clés séparées pour la recherche, la génération d’images et la synthèse vocale, hermes setup --portal vous connecte à Nous Portal en OAuth et relie le tout à un seul abonnement.

Pour changer d’avis plus tard, hermes model remplace le fournisseur et hermes tools active ou désactive les outils. Vérifiez que l’installation est saine avec :

hermes doctor

Puis démarrez une conversation pour valider la chaîne complète :

hermes

Si l’appel au modèle échoue ici, c’est presque toujours la clé d’API ou une faute de frappe dans l’URL du fournisseur. hermes doctor nomme le composant fautif au lieu de vous faire lire des logs.

Étape 4 : Ajouter une passerelle de messagerie

La passerelle est ce qui rend le VPS utile : l’agent continue de travailler quand votre portable est fermé. Telegram est le premier canal le plus simple. Créez un bot via @BotFather et gardez le jeton sous la main, puis :

hermes gateway setup

L’assistant demande quelles plateformes activer et réclame le jeton. Hermes pilote Telegram, Discord, Slack, WhatsApp, Signal, l’e-mail et Home Assistant depuis ce même processus : ajoutez donc tous les canaux voulus maintenant plutôt que de recommencer plus tard.

Restreignez le bot à votre seul compte pendant la configuration. Un bot Telegram est joignable publiquement par quiconque trouve son identifiant, et un bot ouvert dépense vos crédits pour des inconnus. Récupérez votre identifiant via @userinfobot.

Démarrez-la :

hermes gateway start

Envoyez un message à votre bot. La première réponse est plus lente car l’agent charge son contexte.

Étape 5 : Le voir écrire une compétence

Demandez à Hermes quelque chose de non trivial. Bon premier test : « Cherche sur GitHub les dépôts Python en tendance cette semaine et résume les trois premiers. »

Après une tâche complexe, l’agent écrit une compétence réutilisable. Listez ce qu’il possède :

ls ~/.hermes/skills/

Ou, depuis une conversation, /skills. La prochaine fois que vous poserez une question similaire, il exécutera la procédure enregistrée au lieu de raisonner à partir de zéro, et la compétence continuera de s’affiner à l’usage. Les compétences suivent le standard ouvert agentskills.io, elles restent donc portables.

Séparément, Hermes indexe les conversations passées avec SQLite FTS5, ce qui lui permet de répondre à « qu’est-ce que je t’ai dit sur la base de staging le mois dernier » sans que vous ayez à réexpliquer.

Étape 6 : Le maintenir en marche après votre déconnexion

C’est l’étape que tous les guides de démarrage sautent, et la raison pour laquelle beaucoup croient leur installation cassée. hermes gateway start meurt avec votre session SSH. Deux commandes règlent le problème définitivement.

D’abord, autorisez les services de votre utilisateur à tourner sans session active :

sudo loginctl enable-linger $USER

Créez ensuite une unité systemd utilisateur dans ~/.config/systemd/user/hermes-gateway.service :

[Unit]
Description=Hermes Agent messaging gateway
After=network-online.target

[Service]
ExecStart=%h/.local/bin/hermes gateway start
Restart=always
RestartSec=10

[Install]
WantedBy=default.target

Activez-la et démarrez-la :

systemctl --user daemon-reload
systemctl --user enable --now hermes-gateway

Surveillez-la avec systemctl --user status hermes-gateway et lisez sa sortie via journalctl --user -u hermes-gateway -n 50. Vérifiez que le chemin d’ExecStart correspond à l’emplacement réel du binaire, que which hermes vous donnera.

La passerelle survit désormais à la déconnexion comme au redémarrage.

Étape 7 : Configurer des sauvegardes automatiques

Tout ce qui est irremplaçable vit dans ~/.hermes : vos compétences, votre configuration et l’index des conversations. Sauvegardez-le régulièrement :

sudo crontab -e

Ajoutez :

0 3 * * * tar -czf /backup/hermes-$(date +\%Y\%m\%d).tar.gz -C $HOME .hermes && find /backup -name "hermes-*.tar.gz" -mtime +14 -delete

Cela crée des sauvegardes quotidiennes à 3h du matin et conserve 14 jours. Adaptez la destination à l’endroit où vous stockez vos sauvegardes (S3, Backblaze, disque séparé).

Ce qui vous attend ensuite

La première semaine d’utilisation d’Hermes consiste principalement à ajouter des intégrations (Slack, Discord, calendrier, GitHub) et à le laisser accumuler des compétences. Vers la troisième semaine, la vitesse accrue grâce aux compétences commence à se faire sentir. Vers la sixième semaine, Hermes devient significativement plus rapide pour vos tâches récurrentes qu’un prompt GPT-5 neuf.

Quelques intégrations à ajouter ensuite :

• Passerelle Slack pour usage en équipe
• Outil de gestion de fichiers pour le travail documentaire
• Intégration calendrier pour la planification
• MCP GitHub pour les requêtes liées au code

Pour une vision plus globale de la place d’Hermes dans l’écosystème des agents, consultez la comparaison des meilleurs VPS pour Hermes Agent. Pour d’autres configurations d’agents IA, voir les Guides SelfHostVPS.