Hermes Agent est un agent IA open source qui transforme votre terminal en assistant intelligent. Contrairement aux chatbots classiques comme ChatGPT ou Claude sur navigateur, Hermes ne se contente pas de discuter : il agit. Il exécute des commandes, lit et modifie des fichiers, navigue sur le web, gère vos emails, contrôle votre maison connectée, et bien plus — le tout depuis votre terminal ou vos messageries préférées.
Développé par NousResearch et hébergé sur GitHub, Hermes Agent se distingue par son approche centrée sur l'action plutôt que sur la conversation. C'est un véritable assistant autonome qui comprend le contexte, utilise des outils, et s'adapte à vos workflows. Et le tout gratuitement si vous fournissez votre propre clé API.
Dans cet article, nous allons découvrir ce qu'est Hermes Agent, pourquoi il se démarque de la concurrence, et l'installer pas à pas — que ce soit sur votre machine locale, sur un VPS pour un bot 24/7, ou même sur Android via Termux.
Pourquoi choisir Hermes Agent ?
Le marché des agents IA explose, mais la plupart des solutions sont propriétaires, coûteuses, ou limitées à un usage de conversation basique. Hermes Agent coche des cases que peu de concurrents couvrent simultanément.
Open source et gratuit
Le code est sur GitHub, la communauté est active, et vous n'êtes pas enfermé dans un écosystème payant. Vous payez uniquement les coûts de l'API du modèle que vous choisissez — et avec des modèles comme DeepSeek (qui propose un modèle gratuit) ou les options gratuites d'OpenRouter, la facture peut être proche de zéro. Pas d'abonnement mensuel obligatoire, pas de fonctionnalités bloquées derrière un paywall.
Multi-fournisseur de modèles
Hermes n'est pas lié à un seul modèle IA. Vous pouvez utiliser Claude (Anthropic), GPT (OpenAI), Gemini, DeepSeek, Qwen, Llama, ou n'importe quel endpoint compatible OpenAI. Vous changez de modèle en une seule commande si vous trouvez un meilleur rapport qualité/prix. Cette flexibilité est rare chez les agents IA, qui sont généralement verrouillés sur un fournisseur.
Concrètement, vous pouvez commencer avec Claude pour la qualité, basculer sur DeepSeek pour les tâches simples afin de réduire les coûts, et utiliser un modèle local via Ollama pour les données sensibles — le tout sans quitter Hermes.
68 outils intégrés
Terminal, gestion de fichiers, recherche web, navigateur automatisé, emails, GitHub, Spotify, vision (analyse d'images), génération d'images, synthèse vocale (TTS), reconnaissance vocale (STT), cron jobs, délégation de tâches, base de données kanban — la liste est impressionnante. La plupart des agents IA se limitent à 5 ou 10 outils. Hermes en offre 68, et chaque outil est activable ou désactivable selon vos besoins et votre niveau de confiance.
Gateway multi-plateforme
Un seul agent, toutes vos plateformes : Telegram, Discord, Slack, WhatsApp, Signal, Email, Home Assistant, Microsoft Teams. Vous configurez une fois, et votre assistant est disponible partout avec le même contexte et les mêmes capacités. Cette fonctionnalité seule justifie l'adoption de Hermes pour quiconque gère plusieurs canaux de communication.
Mémoire persistante et extensible
Contrairement à la plupart des chatbots qui oublient tout à chaque session, Hermes maintient une mémoire跨 sessions via plusieurs mécanismes : des fichiers de contexte (CLAUDE.md, AGENTS.md), une mémoire déclarative persistante injectée à chaque session, et un système de skills (compétences réutilisables) qui sert de mémoire procédurale.
Skills : l'agent qui apprend
Le système de skills est peut-être la fonctionnalité la plus sous-estimée de Hermes. Les skills sont des documents de connaissances que l'agent charge à la demande. Mais surtout, Hermes peut créer ses propres skills après avoir résolu un problème complexe. Il mémorise la procédure et la réutilise dans les sessions futures — une forme d'apprentissage procédural automatisé qui le rend de plus en plus compétent avec le temps.
Prérequis techniques
Avant d'installer Hermes Agent, voici ce dont vous avez besoin :
Système d'exploitation
Linux, macOS ou WSL2. Windows natif n'est pas supporté. Si vous êtes sur Windows, installez WSL2 (Windows Subsystem for Linux) — c'est gratuit et l'installation prend 5 minutes. Ouvrez PowerShell en administrateur et tapez wsl --install, puis redémarrez.
Les utilisateurs macOS n'ont rien de spécial à faire — l'installateur fonctionne nativement sur Intel et Apple Silicon.
Les utilisateurs Android peuvent installer via Termux, un terminal Linux disponible sur le Play Store ou F-Droid. L'installateur détecte automatiquement Termux et adapte l'installation.
Git (seul prérequis)
C'est le seul paquet que vous devez installer manuellement. L'installateur s'occupe du reste :
- uv (gestionnaire de paquets Python ultra-rapide)
- Python 3.11 (via uv, pas besoin de sudo)
- Node.js v22 (pour l'automatisation navigateur et le pont WhatsApp)
- ripgrep (recherche de fichiers ultra-rapide)
- ffmpeg (conversion audio pour la synthèse vocale)
Sur Ubuntu/Debian : sudo apt install git
Sur macOS : brew install git (ou installé par défaut avec Xcode CLT)
Clé API LLM
Vous avez besoin d'au moins un fournisseur de modèle IA. Les options les plus accessibles :
Anthropic (Claude) — Clé API sur console.anthropic.com. Modèles les plus performants pour le code et le raisonnement. Tarification au token.
OpenAI — Clé API sur platform.openai.com. Accès à GPT-4o, GPT-4, et modèles de reasoning. Tarification au token.
OpenRouter — Clé API sur openrouter.ai. Agrégateur qui donne accès à des dizaines de modèles (Claude, GPT, Llama, Mistral, etc.) depuis une seule clé. Certains modèles sont gratuits.
DeepSeek — Clé API sur platform.deepseek.com. Excellent rapport qualité/prix, souvent 10x moins cher qu'Anthropic pour des performances comparables sur certaines tâches.
Nous Portal — Abonnement intégré directement dans Hermes, configuration zéro. Option la plus simple pour démarrer sans gérer de clé API.
Minimum requis : 64 000 tokens de contexte. La quasi-totalité des modèles modernes (Claude, GPT-4, Gemini, Qwen, DeepSeek) dépassent largement ce seuil. Si vous utilisez un modèle local via Ollama ou llama.cpp, assurez-vous de configurer au moins 64K de contexte (--ctx-size 65536).
Installation sur votre machine locale
L'installation de Hermes Agent est conçue pour être la plus simple possible — une seule commande suffit sur les systèmes supportés.
L'installateur en une ligne
Ouvrez votre terminal et exécutez :
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
L'installateur détecte votre système (Linux, macOS, WSL2, ou Termux) et configure tout automatiquement :
- Clone le dépôt GitHub
- Installe Python 3.11 via uv (pas besoin de sudo)
- Installe Node.js v22 pour l'automatisation navigateur
- Configure ripgrep pour la recherche de fichiers
- Installe ffmpeg pour la conversion audio
- Crée l'environnement virtuel Python
- Rend la commande
hermesdisponible globalement dans votre PATH
Le processus prend généralement entre 1 et 3 minutes selon la vitesse de votre connexion et la puissance de la machine.
Après l'installation
Rechargez votre shell pour que la commande hermes soit disponible :
source ~/.bashrc
# ou si vous utilisez zsh :
source ~/.zshrc
Vérifiez que tout fonctionne :
hermes --version
Si vous voyez un numéro de version s'afficher, l'installation est réussie. En cas d'erreur hermes: command not found, vérifiez que le shell a bien été rechargé, ou ajoutez manuellement le chemin à votre PATH.
Où sont installés les fichiers ?
L'installateur place les fichiers différemment selon que vous installez en mode utilisateur ou en mode root :
Mode utilisateur (par défaut, sans sudo) :
- Code source : ~/.hermes/hermes-agent/
- Binaire : ~/.local/bin/hermes (symlink)
- Données : ~/.hermes/
Mode root (si vous utilisez sudo curl ... | sudo bash) :
- Code source : /usr/local/lib/hermes-agent/
- Binaire : /usr/local/bin/hermes
- Données : /root/.hermes/ (ou $HERMES_HOME)
Le mode root utilise une disposition FHS standard qui correspond à l'emplacement des autres outils de développement système. C'est utile pour les déploiements partagés où une seule installation système sert plusieurs utilisateurs. La configuration utilisateur (auth, skills, sessions) reste sous le ~/.hermes/ de chaque utilisateur.
Installation sur un VPS pour un bot 24/7
Pour un usage permanent — bot Telegram, automatisation planifiée, cron jobs, gateway multi-plateforme — un VPS (Virtual Private Server) est la solution idéale. Hermes Agent y tourne en arrière-plan et reste disponible en permanence, sans dépendre de votre ordinateur personnel.
Pourquoi un VPS pour Hermes ?
Hermes Agent consomme très peu de ressources locales : tout le traitement IA est effectué par le fournisseur de modèle (Anthropic, OpenAI, etc.), pas par votre machine. Le VPS ne sert qu'à faire tourner le processus Hermes et la gateway de messagerie. Vous n'avez donc pas besoin d'un VPS avec GPU — un VPS basique suffit largement.
Choisir un VPS adapté
Configuration recommandée :
- 1 vCPU minimum
- 1 Go RAM minimum (2 Go recommandé pour le confort)
- 10 Go de stockage SSD
- Ubuntu 22.04 ou 24.04 LTS (recommandé pour la compatibilité)
Hostinger propose des VPS KVM parfaitement adaptés à cet usage, à partir de quelques euros par mois. Leurs VPS sont rapides, bien documentés, et l'installation d'Ubuntu se fait en un clic depuis leur panel de gestion. Ils offrent aussi un excellent rapport qualité/prix pour les petits projets comme un bot Telegram ou un agent d'automatisation.
Procédure d'installation sur VPS
Une fois votre VPS provisionné et Ubuntu installé, connectez-vous en SSH :
ssh root@adresse-ip-de-votre-vps
Mettez à jour le système et installez git :
apt update && apt upgrade -y
apt install git -y
Lancez l'installateur Hermes :
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
Rechargez le shell :
source ~/.bashrc
Hermes Agent s'installera en mode root sur le VPS. Le répertoire de données sera /root/.hermes/, et le code source dans /usr/local/lib/hermes-agent/.
Configuration du provider sur le VPS
Après l'installation, configurez votre fournisseur de modèle :
hermes model
Le menu interactif vous guide dans le choix du provider et la saisie de la clé API. Pour un VPS dédié au bot, voici les configurations recommandées :
Usage intensif (beaucoup de conversations, tasks complexes) : Anthropic Claude — le plus fiable pour les tâches longues et multi-étapes.
Usage économe (bot simple, automatisation légère) : DeepSeek — 10x moins cher, performances solides.
Usage gratuit (tests, développement) : OpenRouter avec des modèles gratuits ou Nous Portal.
Lancement en arrière-plan avec systemd
Pour que Hermes tourne en permanence et redémarre automatiquement en cas de problème, la méthode recommandée est systemd :
cat > /etc/systemd/system/hermes.service << 'EOF'
[Unit]
Description=Hermes Agent Gateway
After=network.target
[Service]
Type=simple
User=root
ExecStart=/usr/local/bin/hermes gateway
Restart=always
RestartSec=10
Environment=HERMES_HOME=/root/.hermes
[Install]
WantedBy=multi-user.target
EOF
systemctl daemon-reload
systemctl enable hermes
systemctl start hermes
Vérifiez que tout fonctionne :
systemctl status hermes
hermes gateway status
Votre agent tourne maintenant 24/7 et redémarre automatiquement en cas de crash ou de redémarrage du VPS.
Alternative : tmux (pour les tests rapides)
Si vous voulez tester rapidement sans configurer systemd :
tmux new -s hermes
hermes gateway
# Ctrl+B puis D pour détacher la session
# tmux attach -t hermes pour revenir
Note : tmux ne redémarre pas automatiquement après un reboot du VPS. Pour la production, privilégiez systemd.
Installation sur Android via Termux
Hermes Agent fonctionne aussi sur Android grâce à Termux — un terminal Linux complet pour mobile. C'est parfait pour chatter avec l'agent en déplacement, faire des recherches web, ou gérer des fichiers.
Prérequis Android
- Installez Termux depuis F-Droid (recommandé) ou le Play Store
- Ouvrez Termux et laissez l'application initialiser ses packages
Installation
Lancez l'installateur — il détecte automatiquement Termux et adapte l'installation :
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
L'installateur Termux configure spécifiquement :
- Les dépendances via pkg (le gestionnaire de paquets de Termux)
- L'environnement virtuel Python avec python -m venv
- La variable ANDROID_API_LEVEL pour les builds de wheels Android
- Un set d'extras compatibles Android
Rechargez le shell :
source ~/.bashrc
Limitations sur Android
Certaines fonctionnalités sont limitées ou indisponibles sur Termux : le navigateur automatisé et le pont WhatsApp sont désactivés par défaut. L'espace disque est souvent plus restreint, et les performances dépendent de votre appareil. C'est un excellent complément pour le chat et la recherche, mais les tâches gourmandes sont mieux adaptées à un VPS.
Configuration initiale et premier chat
Le setup interactif
La méthode la plus simple pour tout configurer en une passe :
hermes setup
Ce wizard interactif vous guide à travers :
- Le choix du modèle IA et du fournisseur
- La saisie de la clé API
- La sélection des outils activés
- La configuration des plateformes de messagerie
- Les préférences générales
Configuration manuelle (avancée)
Si vous préférez contrôler chaque paramètre, deux fichiers gèrent votre configuration :
~/.hermes/.env — secrets et tokens (jamais à commiter) :
ANTHROPIC_API_KEY=sk-ant-...
OPENROUTER_API_KEY=sk-or-...
~/.hermes/config.yaml — configuration non sensible :
model: anthropic/claude-sonnet-4
terminal:
backend: local
Utilisez hermes config set pour modifier les valeurs — le bon fichier est automatiquement mis à jour selon le type de valeur :
hermes config set model anthropic/claude-sonnet-4
hermes config set terminal.backend docker
hermes config set OPENROUTER_API_KEY sk-or-v1-...
Diagnostic : hermes doctor
Hermes inclut un outil de diagnostic complet :
hermes doctor
Cette commande vérifie l'intégralité de votre installation : dépendances système, configuration, clé API, connectivité réseau, permissions. Si quelque chose ne va pas, hermes doctor vous dit exactement quoi corriger et comment.
Premier lancement
Lancez votre première session :
hermes # CLI classique (prompt_toolkit)
hermes --tui # Interface TUI moderne (recommandé)
L'interface TUI offre une expérience plus moderne avec des modals, la sélection à la souris, et un input non-bloquant. Les deux interfaces partagent les mêmes sessions, slash commands, et configuration — essayez les deux et choisissez celle qui vous convient.
Testez avec une demande concrète et vérifiable :
Résume le contenu de mon dossier courant en 5 points.
Quel est l'espace disque utilisé ? Montre les 5 plus gros répertoires.
Cherche les 3 dernières versions de Node.js et explique les différences.
Reprise de session
Les sessions sont sauvegardées automatiquement. Pour reprendre là où vous vous êtes arrêté :
hermes --continue
# ou raccourci :
hermes -c
Dépannage courant
| Problème | Solution |
|---|---|
hermes: command not found |
Rechargez votre shell : source ~/.bashrc ou vérifiez le PATH |
API key not set |
Lancez hermes model pour configurer votre provider |
| Configuration cassée après un update | hermes config check puis hermes config migrate |
| Réponses vides ou incohérentes | Vérifiez le provider et le modèle avec hermes model |
| Le gateway ne démarre pas | hermes gateway status pour diagnostiquer |
hermes --continue ne trouve pas la session |
Vérifiez avec hermes sessions list que vous êtes dans le bon profil |
| Modèle indisponible | Vérifiez votre quota API ou changez de modèle |
En cas de doute, la séquence de récupération recommandée est :
hermes doctor
hermes model
hermes setup
hermes sessions list
hermes --continue
Cette séquence vous ramène d'un état "cassé" à un état fonctionnel en quelques commandes.
Conclusion
Hermes Agent est probablement l'agent IA open source le plus complet disponible aujourd'hui. Son installation est conçue pour être accessible à tous — une seule commande et quelques minutes suffisent pour passer de zéro à un assistant IA pleinement fonctionnel, capable d'exécuter des commandes, de naviguer sur le web, et de gérer vos fichiers.
Que vous l'installiez sur votre machine locale pour un usage quotidien de développement, ou sur un VPS pour un bot Telegram 24/7, la procédure est identique et la barrière à l'entrée est minimale. Le choix du VPS via Hostinger offre un excellent point de départ pour quelques euros par mois.
Le vrai pouvoir de Hermes Agent se révèle quand vous commencez à exploiter ses outils avancés : automatiser des tâches récurrentes, gérer des projets complexes, orchestrer plusieurs agents en parallèle. C'est ce que nous explorerons dans les prochains articles de cette série — du quotidien avec le CLI à l'automatisation avancée avec les cron jobs, les skills, et la délégation de tâches.
Si vous n'avez pas encore installé Hermes Agent, c'est le moment. Prenez 5 minutes, lancez l'installateur, configurez votre modèle préféré, et dites bonjour à votre nouvel assistant.