Installer Hermes Agent sur VPS : tutoriel complet 2026

Hermes Agent est un agent IA open source développé par Nous Research. Installé sur un VPS, il reste disponible 24 h/24, exécute vos tâches, conserve sa mémoire et répond depuis Telegram, Discord, WhatsApp ou d’autres plateformes.

Mes vidéos Hermes Agent

Vous préférez voir le résultat avant de suivre les commandes ? Voici mes tutoriels et démonstrations Hermes Agent. Les liens s’ouvrent directement sur ma chaîne YouTube.

1. Choisir un VPS adapté à Hermes Agent

Hermes utilise généralement un modèle distant via un fournisseur d’API. Le VPS orchestre donc l’agent, ses outils, sa mémoire et son Gateway ; il n’a pas besoin d’une carte graphique pour ce cas d’usage.

Repères pratiques : ces valeurs concernent un Hermes connecté à un modèle distant. Un modèle exécuté localement demande beaucoup plus de RAM et, selon sa taille, un GPU.

2. Préparer et sécuriser le serveur

Connectez-vous au VPS en SSH, puis mettez le système à jour :

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

Évitez d’exécuter votre agent en permanence avec le compte root. Créez un utilisateur dédié :

sudo adduser hermes
sudo usermod -aG sudo hermes
sudo su - hermes

Si le VPS est neuf, activez un pare-feu sans couper votre accès SSH :

sudo ufw allow OpenSSH
sudo ufw enable
sudo ufw status

Vous n’avez pas besoin de screen pour le mode 24/7 final : le Gateway sera installé comme service système. screen ou tmux reste pratique uniquement pendant vos essais manuels.

3. Installer Hermes Agent sur le VPS

La méthode officielle la plus simple est le script d’installation de Nous Research :

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Le script prépare l’environnement, installe Hermes et lance l’assistant de configuration. Une fois l’installation terminée, rechargez votre shell si la commande n’est pas encore trouvée :

source ~/.bashrc

Vous pouvez ensuite afficher la version installée :

hermes --version

4. Configurer le modèle et vérifier l’installation

Lancez l’assistant si vous l’avez quitté pendant l’installation :

hermes setup

Choisissez votre fournisseur et votre modèle dans l’assistant. Les clés et identifiants doivent rester dans la configuration privée du serveur, jamais dans une commande publiée, une capture d’écran ou un dépôt Git.

Contrôlez ensuite les dépendances et l’état de Hermes :

hermes doctor
hermes status --all

Enfin, démarrez une session interactive :

hermes

Posez une question simple, puis demandez une action utilisant un outil. Une réponse textuelle seule confirme le modèle ; une action réelle confirme aussi le bon fonctionnement des outils.

5. Installer le Gateway Hermes en mode 24/7

Le Gateway maintient les connexions avec vos plateformes de messagerie et exécute les automatisations programmées. Configurez d’abord la ou les plateformes voulues :

hermes gateway setup

Installez ensuite le service en arrière-plan, puis démarrez-le :

hermes gateway install
hermes gateway start
hermes gateway status

Le service redémarre automatiquement avec le VPS. Si vous modifiez la configuration ou ajoutez une plateforme, redémarrez uniquement le Gateway :

hermes gateway restart

Commandes utiles pour Telegram, Discord et WhatsApp

• hermes gateway setup : ajouter ou modifier une plateforme.
• hermes pairing list : voir les demandes d’association en attente.
• hermes pairing approve : autoriser un utilisateur ou un appareil.
• hermes gateway status : vérifier que le service tourne.

Chaque plateforme a ses propres prérequis. Par exemple, un bot Discord doit disposer de l’intention Message Content pour lire les messages, tandis que WhatsApp nécessite une association de session.

6. Ajouter des skills, outils et tâches planifiées

Une fois l’agent stable, enrichissez-le progressivement plutôt que d’activer tout ce qui existe.

hermes tools list
hermes skills list
hermes cron list

Les skills donnent à l’agent des procédures spécialisées. Les outils lui permettent d’agir. Les tâches cron planifient des actions récurrentes. Après avoir modifié les outils ou les skills disponibles, démarrez une nouvelle session pour que le contexte soit rechargé proprement.

7. Mettre à jour Hermes Agent

La mise à jour standard se fait en une commande :

hermes update

Après une mise à jour importante, vérifiez la configuration et redémarrez le Gateway :

hermes config check
hermes doctor
hermes gateway restart
hermes gateway status

Résoudre les problèmes fréquents

hermes: command not found

Rechargez le shell avec source ~/.bashrc, reconnectez-vous en SSH, puis vérifiez que le répertoire d’installation est bien présent dans votre PATH.

Le modèle ne répond pas

Lancez hermes doctor, vérifiez le fournisseur sélectionné et reconnectez l’authentification avec hermes login si vous utilisez un fournisseur OAuth.

Telegram ou Discord reste silencieux

Contrôlez hermes gateway status, les autorisations du bot et les demandes dans hermes pairing list. Après une correction, exécutez hermes gateway restart.

La modification de configuration n’est pas prise en compte

Les changements liés aux outils et skills s’appliquent à la session suivante. Pour le Gateway, utilisez hermes gateway restart.

Pour aller plus loin

Ce tutoriel couvre une installation propre, vérifiable et maintenable. La documentation officielle reste la référence pour les fournisseurs, les plateformes de messagerie, les outils et les options avancées.