Comment installer l’agent IA Hermes sur un VPS Linux

Tutoriel complet : installer l’agent IA Hermes sur un VPS Linux

Dans ce guide, nous allons voir pas à pas comment installer et configurer l’agent IA Hermes sur un serveur VPS Linux. L’objectif : obtenir un agent autonome qui reste allumé 24h/24 sur votre VPS, capable d’exécuter des commandes, d’automatiser des tâches et de répondre via terminal, Telegram, Discord ou d’autres canaux.

Hermes Agent est un agent IA open source développé par Nous Research. Il sait planifier des actions, exécuter du code, utiliser des outils (web, shell, etc.) et s’améliore au fil des interactions. Installé sur un VPS, il devient un véritable assistant autonome en arrière-plan pour vos projets. Si vous vous intéressez aux assistants autonomes de ce type, découvrez également notre guide pour installer OpenClaw sur un VPS Linux.

---

1. Prérequis sur votre VPS Linux

Avant de commencer, assurez-vous d’avoir :

• Un serveur VPS Linux (Ubuntu 22.04 ou 24.04 recommandé, Debian 12 ou équivalent fonctionne également)
• Un accès SSH avec un utilisateur disposant de sudo
• Au moins 1 à 2 Go de RAM si vous utilisez des modèles hébergés via API
• Une clé API pour votre fournisseur de modèles (OpenAI, Anthropic, OpenRouter, etc.), ou un serveur local type Ollama si vous souhaitez des modèles locaux

Mettez le système à jour et installez les outils de base.

Ubuntu / Debian :

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

AlmaLinux / Rocky Linux :

sudo dnf update -y
sudo dnf install -y curl git

---

2. Installation de Hermes Agent via le script officiel

Hermes fournit un installateur « tout-en-un » pour Linux qui gère Python, Node.js et les dépendances.

Sur votre VPS, exécutez :

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

Rechargez ensuite votre shell pour que la commande hermes soit disponible :

source ~/.bashrc

Vérifiez que tout est en place :

hermes --version

Exemple de sortie :

Hermes Agent v0.16.0 (2026.6.5)
Project: /usr/local/lib/hermes-agent
Python: 3.11.15
OpenAI SDK: 2.24.0
Up to date

Si la commande n’est pas trouvée, vérifiez que ~/.local/bin est bien dans votre PATH ou relancez votre session SSH.

---

3. Configuration initiale de Hermes (wizard interactif)

Hermes fournit un assistant complet de configuration.

Lancez :

hermes setup

L’assistant vous guide pour la configuration (vous pouvez également opter pour l’option rapide « Quick Setup via Nous Portal ») :

• Choisir un fournisseur de modèle (OpenAI, Anthropic, OpenRouter, Ollama, etc.)
• Renseigner votre clé API si vous utilisez un modèle distant
• Choisir le modèle par défaut (avec recherche floue sur le model picker)
• Confirmer l’emplacement de stockage (par défaut ~/.hermes pour la mémoire, les compétences, les logs)

Vous pourrez ensuite modifier ce choix avec :

hermes model

---

4. Activer le backend Docker pour isoler l’exécution

Hermes est capable d’exécuter des commandes shell et du code. Sur un VPS, il est fortement recommandé de le faire dans un sandbox Docker plutôt que directement sur l’hôte.

Installez Docker selon votre distribution. Pour plus de détails ou d’autres configurations, consultez notre tutoriel complet pour installer Docker sur Linux.

Ubuntu / Debian :

sudo apt-get remove -y docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo systemctl enable --now docker
sudo usermod -aG docker $USER

AlmaLinux / Rocky Linux :

sudo dnf install -y dnf-plugins-core
sudo dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
sudo dnf install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
sudo systemctl enable --now docker
sudo usermod -aG docker $USER

Reconnectez-vous à votre session (ou utilisez newgrp docker) pour appliquer l’ajout au groupe docker.

Dites ensuite à Hermes d’utiliser Docker comme backend terminal :

hermes config set terminal.backend docker

Exemple de sortie :

✓ Set terminal.backend = docker in ~/.hermes/config.yaml

Vous pouvez revenir au mode local plus tard avec :

hermes config set terminal.backend local

---

5. Administrer et interagir avec votre agent (Desktop, Dashboard ou Terminal)

Pour gérer, configurer et discuter avec votre agent Hermes sur votre VPS, la méthode recommandée est d’utiliser l’application de bureau Hermes Desktop. Elle sert de centre de contrôle graphique principal. Des alternatives via navigateur ou directement en ligne de commande restent disponibles pour s’adapter à toutes les habitudes de travail.

Option A (Recommandé) : L’application native Hermes Desktop

L’application native Hermes Desktop s’installe sur votre ordinateur personnel (Windows, macOS, Linux) et se connecte à distance au démon Hermes qui tourne sur votre VPS. Elle offre une interface native polie avec streaming de chat, historique de sessions, glisser-déposer de fichiers et sélecteur de modèle.

Comment connecter Hermes Desktop à votre VPS :

1. Sur le VPS, définissez un jeton de session persistant dans le fichier ~/.hermes/.env :
   HERMES_DASHBOARD_SESSION_TOKEN=votre_jeton_securise
2. Lancez le démon sur le VPS en activant les WebSockets (via l’option --tui) pour autoriser la connexion de l’application Desktop :

   hermes --tui dashboard --host 0.0.0.0 --port 9119 --no-open --insecure
   

3. Dans l’application Desktop installée sur votre ordinateur, allez dans l’onglet Gateway de la colonne de gauche, sélectionnez Remote gateway, puis renseignez l’adresse http://<IP_DE_VOTRE_VPS>:9119 dans le champ Remote URL et validez avec Save and reconnect.

Choisir l’environnement d’exécution (Execution Backend) :

Depuis cette interface, vous pouvez configurer l’endroit où Hermes exécute ses commandes en allant dans Settings > Terminal > Execution Backend. En plus de Docker (le choix recommandé, qui exécute les commandes de manière isolée dans un conteneur sur le VPS, comme configuré à l’étape 4), vous pouvez choisir Local (pour exécuter directement sur le système hôte du VPS sans isolation), Ssh (pour déléguer l’exécution à une autre machine distante), Modal / Daytona (serverless dans le cloud), ou Singularity (calcul HPC).

Option B : Le tableau de bord Web (Web Dashboard)

Si vous ne souhaitez pas installer l’application de bureau, Hermes intègre un tableau de bord accessible directement depuis votre navigateur. Il intègre la gestion de votre catalogue MCP, les canaux de messagerie, les identifiants, les webhooks, le stockage mémoire et une authentification sécurisée.

Pour lancer le tableau de bord web sur le VPS :

hermes dashboard --host 0.0.0.0

Il démarre par défaut sur le port 9119. Vous pouvez ensuite y accéder via votre navigateur à l’adresse http://<IP_DE_VOTRE_VPS>:9119 (pensez à ouvrir le port 9119 sur votre pare-feu si vous utilisez cette interface).

Option C : La ligne de commande classique (TUI & CLI)

Pour les développeurs et les administrateurs système qui préfèrent travailler directement dans le terminal SSH :

• Interface texte interactive (TUI) : Lancez la commande hermes pour entrer dans une interface de discussion en temps réel. Saisissez par exemple what can you do as a hermes agent on this server?. Hermes planifie sa réponse, appelle des outils et mémorise l’historique dans ~/.hermes. Quittez avec Ctrl+D ou /quit (vous pouvez annuler les derniers échanges avec /undo).
• Mode « One-Shot » (Commande rapide) : Pour envoyer une commande unique et récupérer directement le résultat textuel brut dans stdout sans entrer dans l’interface interactive :

  hermes -z "Crée un script python qui affiche la météo de Paris"
  

---

6. Configurer les passerelles de messagerie (Telegram, Discord, etc.)

L’un des atouts majeurs d’Hermes sur un VPS est de pouvoir répondre depuis votre téléphone ou vos salons de discussion.

Vous avez deux manières de configurer ces passerelles :

Via l’interface graphique (Dashboard / Application Desktop) :

Rendez-vous dans l’onglet Messaging dans la colonne de gauche de l’interface graphique. Vous y retrouverez tous les canaux supportés (Telegram, Discord, Slack, WhatsApp, Signal, Twilio SMS, etc.).
Par exemple, pour Telegram :

1. Suivez les instructions affichées à l’écran pour obtenir un Bot Token auprès de @BotFather sur Telegram.
2. Renseignez votre Bot Token et éventuellement vos identifiants d’utilisateurs autorisés dans le champ Allowed Telegram user IDs (recommandé pour empêcher quiconque de contrôler votre agent).
3. Activez l’interrupteur en bas de page pour basculer sur Enabled et sauvegardez.

Via le terminal (SSH) :

Si vous préférez le terminal, configurez la passerelle de manière interactive :

hermes gateway setup

L’assistant interactif vous guidera pas à pas pour lier vos comptes Telegram, Discord ou autres canaux.

Vous pouvez ensuite lancer la passerelle au premier plan pour tester la configuration :

hermes gateway

---

7. Faire tourner Hermes en service 24h/24

Si vous lancez simplement hermes gateway dans un terminal SSH, le processus s’arrêtera dès que votre session sera fermée.

Pour rendre l’agent persistant, Hermes intègre des commandes permettant de l’installer automatiquement comme service d’arrière-plan (systemd sur Linux).

Pour l’installer comme service utilisateur (recommandé) :

hermes gateway install

Exemple de sortie dans le terminal :

Start the gateway now after installing the service? [Y/n]: y
Start the gateway automatically on login/boot with systemd? [Y/n]: y
Installing user systemd service to: ~/.config/systemd/user/hermes-gateway.service

✓ User service installed and enabled!

Next steps:
  hermes gateway start              # Start the service
  hermes gateway status             # Check status
  journalctl --user -u hermes-gateway -f  # View logs

✓ Systemd linger is enabled (service survives logout)
✓ User service started

Si vous préférez l’installer au niveau du système global pour qu’il démarre automatiquement au boot du serveur :

sudo hermes gateway install --system

Une fois l’installation effectuée, vous pouvez gérer facilement le cycle de vie du service grâce aux commandes intégrées de Hermes :

Pour vérifier le statut et vous assurer que tout tourne correctement :

hermes gateway status

Exemple de sortie :

● hermes-gateway.service - Hermes Agent Gateway - Messaging Platform Integration
     Loaded: loaded (/home/username/.config/systemd/user/hermes-gateway.service; enabled; preset: enabled)
     Active: active (running) since Fri 2026-06-05 15:13:31 UTC; 2s ago
   Main PID: 3449 (hermes)
      Tasks: 4 (limit: 21479)
     Memory: 82.9M (peak: 97.5M)
        CPU: 2.119s
     CGroup: /user.slice/user-1000.slice/[email protected]/app.slice/hermes-gateway.service
             └─3449 /usr/local/lib/hermes-agent/venv/bin/python -m hermes_cli.main gateway run --replace

Jun 05 15:13:31 demo-vps systemd[1228]: Started hermes-gateway.service - Hermes Agent Gateway.
Jun 05 15:13:33 demo-vps python[3449]: WARNING gateway.run: No messaging platforms configured.
✓ User gateway service is running
✓ Systemd linger is enabled (service survives logout)

---

8. Automatiser des tâches avec hermes cron

Hermes peut planifier des tâches en langage naturel, pratique sur un VPS pour de la supervision ou des rapports.

Exemples de commandes :

hermes cron "every weekday at 8 AM, summarize overnight server logs and send to Telegram"
hermes cron "every hour, check if https://example.com returns 200 and alert me if not"
hermes cron "every Friday at 5 PM, list all commits across my Git repos this week"

Vous n’avez pas besoin de syntaxe crontab, Hermes traduit ces phrases en jobs planifiés et les exécute tout seul.

---

9. Sécuriser votre VPS et votre agent Hermes

Même si Hermes facilite l’automatisation, il reste un service exposé sur un serveur VPS. Quelques bonnes pratiques :

• Pare-feu : n’ouvrez que les ports nécessaires (SSH par défaut). Notez que si vous utilisez des bots Telegram ou Discord, ils fonctionnent par Long Polling (connexions HTTP sortantes) et ne nécessitent donc aucun port d’entrée (inbound) ouvert sur votre VPS. En revanche, si vous configurez une intégration via webhooks (comme Slack), vous devrez ouvrir le port d’écoute associé (généralement 443 ou un port personnalisé). Utilisez ufw ou firewalld.
• Utilisateur non root : faites tourner Hermes avec un utilisateur normal, ajouté au groupe docker si besoin.
• SSH par clé : désactivez l’authentification par mot de passe dans sshd_config et utilisez des clés SSH.
• Approbation des commandes : dans la configuration Hermes, conservez une validation manuelle pour les actions sensibles plutôt qu’une exécution automatique sans contrôle.
• Sauvegardes : pensez à sauvegarder régulièrement le dossier ~/.hermes (mémoire, configuration, logs) vers un stockage externe.

Avec cette base, votre agent IA Hermes tourne en continu sur votre VPS, prêt à gérer des tâches techniques, de la veille, ou des interactions via vos canaux favoris.

---

Conclusion

En installant Hermes sur un serveur VPS, vous transformez votre machine en véritable assistant IA autonome, parfait pour automatiser des tâches, surveiller vos services ou centraliser vos interactions. Chez BoxToPlay, nous mettons l’accent sur des serveurs VPS performants et stables, idéals pour faire tourner ce type d’agent 24h/24. Si vous voulez tester ce type d’usage par vous-même, vous pouvez dès maintenant lancer votre serveur VPS gratuitement.