Comment configurer Hermes Agent avec Docker

Configurer Hermes Agent consiste à le déployer en tant que conteneur Docker sur un serveur privé virtuel (VPS), à lancer l’assistant de configuration pour choisir un fournisseur d’LLM, puis à vérifier que tout fonctionne avec une courte session de chat.

Hermes Agent est un agent IA toujours actif et auto-améliorant. Il apprend de vos interactions et développe au fil du temps des compétences réutilisables. Une fois qu’il a terminé une tâche, il utilise cette expérience pour mieux gérer les tâches similaires la prochaine fois.

Vous pouvez installer Hermes Agent directement sur un serveur à l’aide de l’installateur natif curl, mais Docker fonctionne mieux pour les déploiements sur VPS. Cela isole l’agent de votre système hôte, et la mise à jour ultérieure se résume simplement à récupérer une nouvelle image.

Voici comment configurer Hermes Agent sur un VPS à l’aide de Docker :

• Préparez votre serveur. Procurez-vous un VPS avec au moins 2 cœurs CPU et 8 Go de RAM. Utilisez une distribution Linux comme Ubuntu.
• Déployez le conteneur. Utilisez le catalogue d’applications de Hostinger pour une installation en un clic, ou récupérez l’image Docker manuellement si vous utilisez un autre fournisseur de VPS.
• Configurez votre fournisseur d’LLM. Lancez l’assistant de configuration, sélectionnez un fournisseur, entrez votre clé API et choisissez un modèle.
• Testez une conversation CLI. Assurez-vous que l’agent répond correctement et peut utiliser des outils avant d’ajouter quoi que ce soit d’autre.
• Ajoutez des modèles, connectez une passerelle et configurez les outils. Configurez des fournisseurs d’LLM supplémentaires, ajoutez Telegram, Discord ou d’autres plateformes, et activez les ensembles d’outils dont vous avez besoin.
• Renforcez votre déploiement. Mettez en place l’analyse des commandes Tirith, configurez des listes d’autorisation pour la passerelle et ajoutez des règles de pare-feu pour sécuriser votre configuration.

1. Préparez votre environnement VPS

Pour faire fonctionner Hermes Agent, vous avez besoin d’un serveur avec une distribution Linux (Ubuntu fonctionne le mieux), ainsi que d’un accès root et d’une connexion Internet stable.

Visez un plan VPS avec au moins 2 cœurs CPU et 8 Go de RAM. Cette configuration gère confortablement l’isolation Docker et le processus de passerelle. Le conteneur lui-même utilise environ 1 Go de RAM, ou 2 à 4 Go si vous activez l’automatisation du navigateur.

Après avoir acheté votre VPS, connectez-vous-y via SSH et mettez à jour les paquets de votre système :

sudo apt update && sudo apt upgrade -y

Cela aide à éviter les conflits de dépendances lors de l’installation de Docker et des composants d’Hermes Agent.

Vous devriez également sécuriser et préparer votre VPS. Créez un utilisateur dédié, ajustez les autorisations et activez l’authentification par clé publique pour un accès plus sûr.

2. Déployez Hermes Agent avec Docker

Docker regroupe Hermes Agent et toutes ses dépendances dans un seul conteneur, donc vous n’avez pas besoin d’installer Python ou Node.js ni de configurer manuellement les variables d’environnement.

Il existe plusieurs façons de le faire fonctionner, selon votre configuration.

Si vous n’avez pas encore de VPS, l’option la plus rapide et la plus simple est d’utiliser le template Hermes Agent de Hostinger. Choisissez votre plan préféré, finalisez le paiement, et le système installe tout automatiquement.

Pendant la configuration, vous créerez un nom d’utilisateur et un mot de passe pour accéder au terminal web d’Hermes Agent.

Une fois l’installation terminée, vous arriverez dans Docker Manager, où Hermes Agent apparaît comme un projet Docker. Cliquez sur Ouvrir à côté, puis connectez-vous avec les identifiants créés précédemment.

Si vous possédez déjà un VPS Hostinger, vous pouvez déployer Hermes Agent depuis hPanel. Allez dans VPS → OS & Panel → Système d’exploitation → Changer d’OS, recherchez Hermes Agent et sélectionnez-le pour lancer l’installation.

Lorsque l’installation se termine, allez dans Docker Manager → Projets et ouvrez le terminal web d’Hermes Agent de la même manière.

Si vous utilisez un autre fournisseur de VPS, installez d’abord Docker. Une fois qu’il est prêt, créez un répertoire de données pour Hermes Agent et ouvrez-le :

mkdir -p ~/.hermes

cd ~/.hermes

Puis déployez le conteneur Hermes Agent :

docker run -it --rm \

-v ~/.hermes:/opt/data \

nousresearch/hermes-agent setup

L’indicateur -v ~/.hermes:/opt/data monte un répertoire de l’hôte vers le chemin de données du conteneur. Hermes Agent stocke ses fichiers de configuration, clés API, sessions, compétences et mémoire dans ce répertoire.

3. Lancez l’assistant de configuration

Après avoir accédé au terminal web ou lancé le conteneur, l’assistant de configuration de Hermes Agent démarre automatiquement. Il vous demande comment vous souhaitez configurer l’agent.

Il propose deux parcours :

• Configuration rapide. Couvre le fournisseur, le modèle et la messagerie. C’est la meilleure option pour la plupart des utilisateurs.
• Configuration complète. Ajoute la sélection du backend du terminal, les paramètres de comportement de l’agent, les bascules des outils et la configuration de la persona.

Nous utiliserons ici la configuration rapide. Vous pouvez configurer tout le reste plus tard, donc rien n’est figé. L’assistant vous guide à travers les étapes suivantes :

• Sélectionnez un fournisseur d’LLM. Choisissez parmi OpenRouter, Anthropic, OpenAI, Nous Portal, Ollama ou un point de terminaison personnalisé.

• Entrez votre clé API. Collez la clé du fournisseur choisi.
• Choisissez un modèle. Sélectionnez-en un parmi les modèles disponibles pour le fournisseur choisi.

• Connectez une plateforme de messagerie. Choisissez Telegram, Discord, Slack, WhatsApp ou une autre plateforme. Vous pouvez ignorer cette étape pour le moment et tester d’abord le chat CLI.

Hermes Agent stocke les données sensibles, comme les clés API, dans ~/.hermes/.env, tandis que les données non sensibles sont enregistrées dans ~/.hermes/config.yaml.

4. Vérifiez que Hermes Agent est en cours d’exécution

Pour vérifier que Hermes Agent fonctionne correctement après l’assistant de configuration, démarrez une session CLI et vérifiez si l’agent peut communiquer avec le modèle que vous avez sélectionné :

hermes

Vous devriez voir une bannière de bienvenue avec le modèle sélectionné, les outils disponibles et les compétences chargées.

Testez-le avec un prompt qui déclenche un outil, comme « Qu’y a-t-il dans mon répertoire actuel ? » Cela confirme que l’agent peut répondre et exécuter des commandes.

Pour quitter la session, tapez /exit. Utilisez hermes pour démarrer une nouvelle session, ou reprendre la dernière avec hermes –continue.

Si l’agent renvoie des réponses vides ou des erreurs de connexion, la cause la plus fréquente est une clé API incorrecte ou un fournisseur mal configuré.

Relancez hermes setup pour reconfigurer votre fournisseur et votre clé API. Vous pouvez également utiliser la commande hermes doctor pour analyser toute votre configuration et identifier le problème.

5. Configurez d’autres modèles, la passerelle et les outils

Une fois le chat CLI opérationnel, vous pouvez ajouter un autre modèle, connecter une plateforme de messagerie et configurer les outils dont votre workflow a besoin.

Pour ajouter un nouveau fournisseur d’LLM en plus de celui que vous avez configuré auparavant, exécutez hermes model. Il vous guide dans la sélection du fournisseur et la saisie de la clé API, tout comme l’assistant de configuration.

Une fois que vous avez configuré plusieurs fournisseurs, basculez de l’un à l’autre pendant une session avec la commande /model dans le chat.

La passerelle de messagerie vous permet de parler à Hermes Agent via des plateformes comme Telegram, Discord, Slack, WhatsApp, Signal ou le courrier électronique, au lieu du CLI.

Utilisez hermes gateway setup pour connecter la plateforme de votre choix, puis suivez les instructions à l’écran.

Après la configuration, exécutez hermes gateway run pour démarrer le bot. Sinon, il reste configuré mais inactif.

Hermes Agent inclut également des outils intégrés comme l’exécution de terminal, la recherche sur le web, l’accès au système de fichiers et la génération d’images. Ouvrez la liste des outils avec hermes tools, puis activez ou désactivez chaque outil selon vos besoins.

Notez que certains outils, comme la recherche sur le web et la génération d’images, nécessitent leurs clés API fonctionnelles.

6. Sécurisez votre configuration de Hermes Agent

La sécurisation de votre configuration de Hermes Agent couvre à la fois les protections intégrées de l’agent et les règles au niveau du serveur qui limitent l’accès externe.

Hermes Agent est fourni avec un analyseur de sécurité appelé Tirith. Il vérifie chaque commande de terminal avant son exécution. Il est activé par défaut et recherche des risques comme l’injection de prompt, l’exfiltration d’identifiants et les schémas de porte dérobée SSH.

Si Tirith signale une commande, vous verrez un résumé du problème. Vous pouvez l’approuver ou la refuser à l’aide de /approve ou /deny. Pour contrôler le fonctionnement des approbations, modifiez ~/.hermes/config.yaml :

approvals:

   mode: manual    # manual | smart | off

   timeout: 60 # seconds to wait for user response (default: 60)

• manual. Demande une approbation avant chaque commande potentiellement risquée.
• intelligent. Approuve automatiquement les opérations à faible risque et ne demande un prompt que pour les opérations dangereuses.
• désactivé. Désactive toutes les vérifications d’approbation.

La passerelle de messagerie a aussi besoin d’être protégée. Dans le même fichier config.yaml, ajoutez votre identifiant utilisateur à la liste autorisée pour chaque plateforme afin que vous soyez le seul à pouvoir envoyer des commandes au bot.

Voici un exemple pour Telegram :

gateway:

   telegram:

      allowed_user_ids:

         - 123456789

Remplacez 123456789 par votre véritable identifiant utilisateur Telegram. Vous pouvez l’obtenir en envoyant un message à @userinfobot sur Telegram.

Pour d’autres plateformes comme Slack ou WhatsApp, remplacez telegram par le nom de la plateforme et utilisez le bon format d’identifiant utilisateur pour ce service.

Au niveau du réseau, fermez les ports 8642 (serveur API) et 9119 (tableau de bord) si vous utilisez Hermes Agent uniquement via des plateformes de chat. La passerelle établit des connexions sortantes, elle n’a donc pas besoin de trafic entrant :

sudo ufw deny 8642

sudo ufw deny 9119

Pour rester à jour, récupérez la dernière image et remplacez le conteneur en cours d’exécution :

docker pull nousresearch/hermes-agent:latest

docker rm -f hermes

docker run -d \

   --name hermes \

   --restart unless-stopped \

   -v ~/.hermes:/opt/data \

   nousresearch/hermes-agent gateway run

Toutes les données résident dans le volume ~/.hermes monté, donc rien n’est perdu pendant les mises à jour.

Pour les utilisateurs de VPS Hostinger, vous pouvez mettre à jour le conteneur directement depuis hPanel. Dans Docker Manager, trouvez votre projet Hermes Agent, cliquez sur le menu à trois points, puis sélectionnez Mettre à jour.

Sécurisez aussi votre VPS en désactivant la connexion SSH root, en configurant fail2ban pour bloquer les tentatives de connexion répétées et en installant un outil d’analyse des logiciels malveillants pour détecter les menaces.

Erreurs courantes lors de la configuration de Hermes Agent

Les problèmes de configuration les plus courants de Hermes Agent incluent l’ajout de fonctionnalités avant de vérifier le chat CLI, l’absence de montage du volume de données, l’utilisation d’identifiants API incorrects, l’omission de la liste autorisée de la passerelle et l’exécution de commandes directement sur l’hôte.

• Ajouter des fonctionnalités avant de vérifier le chat CLI. Connecter Telegram, activer des tâches cron ou intégrer des services tiers avant de confirmer que le chat CLI fonctionne complique le dépannage. Si quelque chose casse, vous ne saurez pas où se situe le problème. Testez d’abord l’agent dans le CLI, confirmez qu’il répond et qu’il peut utiliser des outils, puis ajoutez les autres fonctionnalités.
• Ne pas monter le volume de données. Si vous exécutez le conteneur sans -v ~/.hermes:/opt/data, toutes les données (mémoire, compétences et configuration) restent à l’intérieur du conteneur. Lorsque le conteneur redémarre, tout est perdu. Incluez toujours l’option de volume lorsque vous exécutez le conteneur manuellement.
• Utiliser des identifiants API incorrects ou expirés. Si la clé API est incorrecte ou expirée, l’agent ne peut pas communiquer avec le modèle. Vérifiez à nouveau la clé dans le tableau de bord de votre fournisseur ou générez-en une nouvelle. Puis relancez hermes setup pour la mettre à jour.
• Ignorer la liste autorisée de la passerelle. Si vous configurez un bot de messagerie sans ajouter allowed_user_ids dans config.yaml, toute personne qui trouve le nom d’utilisateur de votre bot peut interagir avec lui. Ajoutez votre identifiant utilisateur à la liste autorisée afin que vous seul puissiez y accéder.
• Laisser le backend terminal par défaut sur un VPS. Par défaut, l’agent exécute les commandes du terminal directement sur votre serveur. Sur un VPS, cela peut affecter l’ensemble de votre système. Passez à un conteneur isolé avec hermes config set terminal.backend docker afin que les commandes s’exécutent dans un environnement isolé.

Comment gérer Hermes Agent après l’installation

La gestion de Hermes Agent après l’installation consiste à maintenir le conteneur et la passerelle en bon état, à planifier des tâches récurrentes avec cron et à utiliser le tableau de bord web pour gérer votre installation.

• Surveiller les journaux et l’état de santé de la passerelle. Les journaux du conteneur sont le premier endroit à vérifier lorsque quelque chose semble anormal. Exécutez docker logs hermes pour consulter la sortie récente, ou docker logs -f hermes pour suivre les journaux en temps réel. Pour la passerelle, utilisez hermes gateway status pour voir quelles plateformes sont connectées, et hermes gateway restart pour reconnecter celles qui se sont déconnectées.
• Planification des tâches récurrentes. Le planificateur cron intégré exécute des tâches telles que des résumés quotidiens, des sauvegardes nocturnes et des rapports hebdomadaires. Il envoie les résultats à vos plateformes de messagerie connectées. Définissez les planifications avec hermes cron, et l’agent gère automatiquement l’exécution.
• Accès au tableau de bord web. Le tableau de bord web est une interface basée sur un navigateur pour gérer votre installation Hermes Agent. Au lieu de modifier des fichiers YAML ou d’exécuter des commandes via l’interface CLI, vous pouvez configurer les paramètres, gérer les clés API, surveiller les sessions et planifier des tâches cron depuis une interface visuelle. Démarrez-le avec la commande ci-dessous, puis ouvrez http://votre-adresse-ip-du-serveur:9119 dans votre navigateur :

docker run -d \

   --name hermes-dashboard \

   --restart unless-stopped \

   -v ~/.hermes:/opt/data \

   -p 9119:9119 \

   nousresearch/hermes-agent dashboard

Que pouvez-vous faire avec Hermes Agent ?

Avec Hermes Agent en cours d’exécution sur votre VPS, vous disposez d’un assistant IA toujours disponible, accessible à tout moment via vos canaux de communication préférés.

Ce que vous en faites dépend de vos besoins – que vous soyez développeur, administrateur système ou que vous souhaitiez un assistant personnel fonctionnant sur votre propre serveur.

Pour les tâches de développement, vous pouvez demander à l’agent de cloner un dépôt, de lancer un environnement de staging et d’exécuter des tests, le tout à partir d’un message Telegram pendant que vous êtes loin de votre bureau.

Les administrateurs système peuvent configurer des tâches cron en langage naturel. Par exemple, vous pouvez programmer l’envoi d’un rapport hebdomadaire d’utilisation du disque sur Slack tous les lundis matin, ou demander à l’agent de surveiller un service et d’envoyer une alerte lorsqu’il tombe en panne.

Pour un usage personnel, vous pouvez demander à l’agent d’envoyer un briefing matinal avec votre calendrier, les principales actualités et vos notifications GitHub avant le début de votre journée.

Si vous souhaitez des exemples plus avancés, notamment des pipelines de production de contenu, l’automatisation des déploiements et des workflows de recherche ou de traitement de données, consultez les cas d’usage les plus populaires de Hermes Agent.

Tout le contenu des tutoriels de ce site est soumis aux normes éditoriales et aux valeurs rigoureuses de Hostinger.

L'auteur

Katerina Bosinaki

Katerina is a Localization Project Manager at Hostinger, bringing over 5 years of project management experience and a 6-year background as a linguist. She focuses on making technology more approachable by transforming complex guides into clear, easy-to-follow tutorials. In her free time, when she’s not staying up-to-date with the latest in localization, she enjoys watching movies and reading books.

Plus d'informations sur Katerina Bosinaki