Installer Hermes Agent sur un VPS Linux

Hermes Agent est un agent IA open source publié par Nous Research : il tourne en continu sur un serveur, garde une mémoire persistante entre les échanges et peut se connecter à Telegram, Discord, Slack, WhatsApp ou vos emails pour recevoir des instructions et agir dessus. Contrairement à un chatbot classique, il ne dépend pas d'un service tiers hébergé : tout tourne chez vous, dans un conteneur Docker que vous contrôlez entièrement.

Ce guide suit la procédure d'installation officielle (le dépôt NousResearch/hermes-agent) sur un VPS Linux. ElypseCloud ne préinstalle pas Hermes Agent lui-même : on vous donne les commandes exactes fournies par l'éditeur, et un VPS avec Docker déjà en place pour sauter la partie la plus fastidieuse.

Ce que fait réellement Hermes Agent

Concrètement, Hermes Agent expose deux choses une fois lancé :

• Une passerelle API compatible OpenAI, qui route vos requêtes vers le modèle de langage de votre choix (Claude, GPT, ou tout autre via OpenRouter et plus de 200 modèles disponibles).
• Un tableau de bord web pour piloter l'agent, consulter ses actions, planifier des tâches récurrentes (cron) et gérer les connecteurs de messagerie.

Les clés API des modèles utilisés restent les vôtres et ne transitent jamais par un serveur tiers : c'est la différence principale avec un agent IA hébergé en SaaS.

Prérequis

• Un VPS Linux avec accès root : 2 vCores et 4 Go de RAM suffisent pour un usage courant, l'éditeur recommande de monter en RAM si vous activez les outils de navigation automatisée de l'agent.
• Docker installé et fonctionnel. Le VPS avec Docker préinstallé évite cette étape.
• Un accès SSH, à privilégier face à une console web pour taper les commandes : certains caractères spéciaux (:, @, =) passent mal dans les consoles navigateur de certains hébergeurs.
• Au moins une clé API de modèle de langage (Anthropic, OpenAI, ou un endpoint compatible OpenRouter).

Configuration initiale

Connectez-vous en SSH à votre VPS, puis lancez l'assistant de configuration officiel. Il crée le dossier de données et vous demande vos clés API :

mkdir -p ~/.hermes
docker run -it --rm \
  -v ~/.hermes:/opt/data \
  nousresearch/hermes-agent setup

Les réponses sont écrites dans ~/.hermes/.env, sur votre serveur : rien n'est envoyé ailleurs que vers les fournisseurs de modèles que vous configurez vous-même.

Lancer l'agent en continu

Une fois la configuration écrite, démarrez le conteneur en mode service, avec redémarrage automatique et les deux ports nécessaires :

docker pull nousresearch/hermes-agent:latest
docker run -d \
  --name hermes \
  --restart unless-stopped \
  -v ~/.hermes:/opt/data \
  -p 8642:8642 \
  -p 9119:9119 \
  -e HERMES_DASHBOARD=1 \
  nousresearch/hermes-agent gateway run

Le port 8642 sert la passerelle API compatible OpenAI, le port 9119 sert le tableau de bord web. Pour vérifier que tout tourne : docker logs -f hermes.

Accéder au tableau de bord en sécurité

Par défaut, exposer le port 9119 sur toutes les interfaces sans authentification est une mauvaise idée sur un VPS avec une IP publique. Deux options officielles :

• Authentification basique, si le VPS reste sur un réseau que vous contrôlez : ajoutez -e HERMES_DASHBOARD_BASIC_AUTH_USERNAME=... et -e HERMES_DASHBOARD_BASIC_AUTH_PASSWORD=... au lancement du conteneur.
• Tunnel SSH, plus strict : bindez le dashboard sur 127.0.0.1 avec -e HERMES_DASHBOARD_HOST=127.0.0.1, puis ouvrez le tunnel depuis votre machine avec ssh -L 9119:127.0.0.1:9119 utilisateur@votre_vps avant de visiter localhost:9119.

Connecter Telegram, Discord ou vos emails

Chaque connecteur de messagerie s'active par une variable d'environnement supplémentaire (par exemple TELEGRAM_BOT_TOKEN pour Telegram), à ajouter à la commande docker run ou directement dans ~/.hermes/.env avant de redémarrer le conteneur. La documentation officielle liste une variable par plateforme supportée : mieux vaut s'y référer au moment de la configuration, la liste s'allonge avec les versions.

Quel VPS pour Hermes Agent

Pour un usage individuel avec un ou deux connecteurs actifs, un VPS Linux d'entrée de gamme (2 vCores, 4 Go de RAM) tient largement la charge : l'agent lui-même consomme peu, le poids réel dépend surtout du nombre d'outils actifs et de sous-agents lancés en parallèle. Si vous préférez partir sur une distribution précise plutôt que le choix par défaut, le VPS Ubuntu est la base la mieux documentée par l'éditeur. Au-delà de plusieurs agents ou d'un usage équipe avec beaucoup d'automatisations en parallèle, un serveur dédié évite de partager les ressources avec d'autres services.

Et si vous préférez ne pas gérer le VPS vous-même

Cette installation reste entièrement manuelle : ElypseCloud fournit le VPS et, en option, Docker déjà prêt à l'emploi, mais pas de suivi ni de mise à jour de l'agent lui-même, ni la gestion de vos clés API. Si l'auto-hébergement d'outils comme celui-ci fait partie de votre usage courant, autant partir sur un VPS avec Docker préconfiguré dès le départ, plutôt que d'installer la brique manuellement à chaque nouveau serveur.