Accueil · Aide · Installer Hermes Agent
Installer Hermes Agent sur un vServer
Hermes Agent est un agent IA open source de Nous Research (licence MIT). Il exécute des tâches dans le terminal, conserve ses connaissances d'une session à l'autre, crée ses propres skills pour les tâches récurrentes et se pilote via Telegram, Discord, Slack, WhatsApp ou Signal. Sur un vServer, il fonctionne en continu, même lorsque votre ordinateur est éteint.
Quel serveur est adapté
Le modèle de langage tourne chez le fournisseur, par exemple Anthropic, OpenAI, OpenRouter ou Nous Portal. Le serveur n'exécute que l'agent lui-même : un processus Python qui envoie des requêtes à l'interface du fournisseur et traite les réponses. En fonctionnement permanent avec Telegram, il utilise selon nos mesures environ 450 Mo de mémoire vive et très peu de temps de calcul.
- Adapté : vServer XS avec 1 vCPU, 2 Go de RAM et 40 Go NVMe, en conteneur avec Debian 13 ou Ubuntu.
- Plus de mémoire est nécessaire pour le pilotage du navigateur avec Chromium (quelques centaines de Mo en plus pendant son fonctionnement) et pour les services de mémoire auto-hébergés avec leur propre base de données.
- Les modèles de langage locaux ne sont pas prévus pour un vServer. Ils exigent une carte graphique avec au moins 8 Go de mémoire. Ce guide utilise donc l'interface d'un fournisseur.
1. Préparer le serveur
En tant que root, mettre à jour, installer les prérequis et créer un utilisateur dédié pour l'agent. L'agent exécute des commandes. Avec son propre utilisateur sans droits d'administrateur, le reste du serveur reste protégé.
apt update && apt full-upgrade
apt install git curl libatomic1
adduser hermes
loginctl enable-linger hermes
loginctl enable-linger garantit que les services de l'utilisateur continuent de tourner après la déconnexion et après un redémarrage.
2. Installer Hermes
Se connecter en tant qu'utilisateur hermes, par exemple via SSH ou avec su - hermes, puis exécuter le script d'installation officiel :
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.bashrc
Le script apporte lui-même Python, Node.js et les autres outils et place tout sous ~/.hermes. Si vous n'avez pas besoin du pilotage du navigateur, vous économisez de la place avec :
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --skip-browser
3. Configurer le fournisseur de modèle
hermes setup
L'assistant demande le fournisseur, le modèle et la clé d'accès. Hermes enregistre les clés et jetons dans ~/.hermes/.env, tous les autres paramètres dans ~/.hermes/config.yaml. Vous changez de fournisseur plus tard avec hermes model. hermes ouvre un chat dans le terminal, ce qui permet de vérifier aussitôt la configuration.
4. Piloter via Telegram et faire fonctionner en continu
La passerelle (gateway) relie Hermes à Telegram et aux autres messageries. La configuration demande l'accès, pour Telegram il s'agit du jeton du bot fourni par @BotFather. Ensuite, install installe la passerelle comme service systemd :
hermes gateway setup
hermes gateway install
hermes gateway start
hermes gateway status
Le journal s'affiche avec journalctl --user -u hermes-gateway -f.
5. Connecter votre compte client Glowfish
Via l'interface IA (MCP), Hermes travaille avec votre compte client : état des serveurs, hébergement web, domaines, boîtes mail, serveurs de jeu, factures et tickets de support. L'interface est gratuite pour les clients.
- Dans l'espace client, sous Applications d'IA, créer une clé. Choisir la désignation, les droits et la durée de validité, et sous Uniquement depuis les adresses IP indiquer l'adresse de votre vServer. La clé n'est affichée qu'une seule fois.
- Inscrire la clé dans
~/.hermes/.env:GLOWFISH_MCP_TOKEN=IHR-SCHLUESSEL - Ajouter le serveur dans
~/.hermes/config.yaml. Hermes insère lui-même la valeur depuis le fichier.env, la clé n'apparaît donc pas dans la configuration :mcp_servers: glowfish: url: "https://mcp.glowfish.de/mcp" headers: Authorization: "Bearer ${GLOWFISH_MCP_TOKEN}" - Vérifier la connexion :
hermes mcp test glowfish
Une passerelle en cours d'exécution reprend d'elle-même la configuration modifiée après environ une minute. Dans un chat ouvert, /reload-mcp recharge immédiatement les serveurs.
Exemples
- « Comment vont mes serveurs ? »
- « Quelles factures sont ouvertes ? »
- « Configure info@mon-domaine.fr. »
- « Redémarre le serveur Valheim. »
- « Envoie-moi chaque matin à 8 heures l'état de mes serveurs. »
Vous confirmez les actions modifiantes dans le chat. Les commandes ne passent qu'avec un code SMS, les mots de passe jamais par le chat. Chaque action est consignée sous Applications d'IA, où vous pouvez couper la connexion à tout moment.
Mettre à jour
hermes update
La commande récupère la dernière version stable et redémarre la passerelle.
Questions fréquentes
- Combien coûte le fonctionnement ?
- Le vServer XS coûte 6,00 € par mois. S'y ajoutent les frais du fournisseur de modèle, à l'usage ou par abonnement.
- Conteneur ou KVM ?
- Le conteneur suffit. KVM n'est nécessaire que pour vos propres modules du noyau, par exemple pour un VPN.
- Hermes peut-il aussi configurer lui-même mon vServer chez Glowfish ?
- Sur son propre serveur, Hermes travaille directement dans le terminal. Via l'interface IA, il peut en plus exécuter des commandes sur d'autres serveurs si vous les autorisez pour cela dans l'espace client.
Suite : Connecter des assistants IA à Glowfish Les premiers pas sur votre vServer Configurer un serveur Debian