Comment installer et utiliser Hermes Agent gratuitement : guide pratique

Hermes Agent est apparu sur mon radar il y a quelques semaines, et après avoir fouillé le repo GitHub (37,5k étoiles, licence MIT, développé par Nous Research), j'ai réalisé qu'il fait quelque chose que la plupart des agents IA ne font pas : il s'améliore plus vous l'utilisez. Pas dans le sens vague de « le modèle s'améliore » — il construit littéralement des compétences à partir de vos interactions, retient ce qui a fonctionné et affine ces compétences au fil du temps. Rien que ça, ça vaut le coup d'y jeter un œil.

Ce qui m'a convaincu : il tourne sur un VPS à 5$. Pas besoin de GPU, sauf si vous en voulez un. Et vous pouvez le connecter à Telegram, Discord, Slack, WhatsApp et une douzaine d'autres plateformes. Nous recommandons d'utiliser LightNode comme fournisseur VPS — leur facturation à l'heure commence à 0,013 $/heure, difficile de faire mieux pour expérimenter avec l'IA auto-hébergée.

Table des matières

1. Ce que Hermes Agent fait réellement
2. Configuration système requise
3. Installation
4. Configurer un fournisseur de modèles gratuit
5. Configuration
6. Lancer votre première session
7. Connexion aux plateformes de messagerie
8. Fonctionnalités clés à connaître
9. Dépannage
10. Pour conclure

Ce que Hermes Agent fait réellement

La plupart des agents IA suivent le même schéma : vous envoyez un prompt, ils exécutent des outils, renvoient un résultat et oublient tout. Hermes Agent adopte une approche différente. Il intègre une boucle d'apprentissage :

1. Vous lui donnez une tâche
2. Il détermine quelles compétences sont nécessaires
3. Si une compétence n'existe pas, il la crée
4. Il utilise la compétence, évalue le résultat et enregistre ce qui a fonctionné
5. La prochaine fois que vous demandez quelque chose de similaire, il ressort la compétence affinée

Ça veut dire que l'agent s'améliore vraiment avec l'usage, pas seulement parce que le modèle sous-jacent a été mis à jour. Vos flux de travail, votre codebase, vos habitudes — il apprend ces patterns.

Au-delà de la boucle d'apprentissage, Hermes Agent est livré avec 47 outils intégrés, prend en charge l'intégration MCP (Model Context Protocol) pour étendre ses capacités, et peut déléguer des tâches à des sous-agents. Il dispose aussi d'un planificateur cron pour les tâches récurrentes et d'un mode vocal si vous voulez rester les mains libres.

Configuration système requise

Avant d'installer, vérifiez que votre système respecte les prérequis :

• OS : Linux (Ubuntu 20.04+ recommandé), macOS (12+) ou Windows via WSL2
• Python : 3.10 ou supérieur
• RAM : 2 Go minimum, 4 Go recommandés
• Disque : ~500 Mo pour l'agent lui-même
• Réseau : Accès Internet pour les appels API au modèle

Pour les utilisateurs Android, Termux fonctionne aussi. Windows natif n'est pas pris en charge — il vous faut WSL2.

Si vous déployez sur un VPS, un serveur à 5 $/mois avec 1 vCPU et 1 Go de RAM suffit pour un usage léger. Des charges de travail plus lourdes (plusieurs plateformes de messagerie, cron jobs fréquents) bénéficient de 2 Go+.

Installation

Il y a deux façons d'installer Hermes Agent. La méthode rapide s'occupe de tout. La méthode manuelle vous donne plus de contrôle.

Méthode 1 : installation en une ligne (recommandée)

Ouvrez votre terminal et lancez :

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

Ce script fait le gros du travail : vérifie les dépendances, crée un environnement virtuel, clone le repo, installe les paquets et lance l'assistant de configuration initial. Sur un Ubuntu fraîchement installé, le tout prend environ 2 à 3 minutes.

Une fois terminé, vérifiez l'installation :

hermes --version

Vous devriez voir le numéro de version s'afficher. Si vous obtenez une erreur « command not found », redémarrez votre shell ou lancez source ~/.bashrc (ou ~/.zshrc si vous utilisez zsh).

Méthode 2 : installation manuelle

Si vous préférez savoir exactement ce qui est installé sur votre machine, ou si l'installateur en une ligne plante pour une raison quelconque :

# Clone the repo
git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

# Create and activate a virtual environment
python3 -m venv venv
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Run the setup wizard
python setup.py

L'assistant de configuration vous guide dans le choix du fournisseur de modèles, la saisie de la clé API et la configuration de base. Vous pouvez toujours le relancer plus tard avec hermes setup.

Configurer un fournisseur de modèles gratuit

Hermes Agent n'embarque pas son propre modèle. Il se connecte à des fournisseurs externes. Bonne nouvelle : plusieurs fournisseurs proposent des offres gratuites compatibles avec Hermes Agent.

Option 1 : OpenRouter (l'option gratuite la plus simple)

OpenRouter vous donne accès à plus de 200 modèles, dont plusieurs sont gratuits. C'est le chemin que je recommande pour démarrer.

1. Créez un compte sur openrouter.ai
2. Générez une clé API depuis votre tableau de bord
3. Trouvez des modèles gratuits — cherchez les modèles marqués « free » dans le catalogue

Les modèles gratuits courants sur OpenRouter incluent des variantes de Llama, Mistral et Qwen. Les modèles disponibles changent régulièrement, consultez le catalogue actuel.

Pendant l'assistant de configuration de Hermes Agent, sélectionnez « OpenRouter » comme fournisseur et collez votre clé API quand on vous la demande.

Option 2 : Nous Portal

Nous Research gère son propre portail d'inférence. Il propose parfois des crédits gratuits pour les nouveaux utilisateurs, et les modèles disponibles sont optimisés spécifiquement pour les charges de travail d'agents.

1. Visitez nousresearch.com et inscrivez-vous
2. Vérifiez votre tableau de bord pour d'éventuels crédits gratuits
3. Utilisez la clé API fournie dans la configuration de Hermes Agent

Option 3 : autres fournisseurs

Hermes Agent prend aussi en charge :

• z.ai / GLM : Plateforme IA chinoise avec un plan gratuit
• Kimi / Moonshot : Autre option avec une utilisation gratuite limitée
• MiniMax : Offre gratuite disponible pour un usage léger
• Tout endpoint compatible OpenAI : Si vous avez accès à d'autres fournisseurs, vous pouvez les brancher

Pour configurer un endpoint personnalisé, vous aurez besoin de l'URL de base et d'une clé API. L'assistant de configuration s'en charge, ou vous pouvez modifier le fichier de config directement (voir la section suivante).

Configuration

Hermes Agent stocke sa configuration dans ~/.hermes/config.toml. Après avoir lancé l'assistant de configuration, vous trouverez quelque chose comme ça :

[model]
provider = "openrouter"
api_key = "sk-or-v1-..."
model = "meta-llama/llama-3.3-70b-instruct:free"

[agent]
name = "Hermes"
memory = true
skills_dir = "~/.hermes/skills"

[messaging]
# Configure messaging platforms here
# telegram_token = ""
# discord_token = ""

Options de configuration clés

Paramètres du modèle : Changez de modèle ou de fournisseur à tout moment. Si vous voulez tester un modèle gratuit différent sur OpenRouter, mettez simplement à jour le champ model. Vous pouvez aussi changer de fournisseur complètement — remplacez provider par "openai" ou "nous" et mettez à jour la clé API en conséquence.

Mémoire : Gardez memory = true. C'est ce qui active la boucle d'apprentissage. L'agent stocke l'historique des conversations et les affinages de compétences dans ~/.hermes/memory/.

Répertoire de compétences : C'est là que les compétences apprises sont sauvegardées. Vous pouvez parcourir ~/.hermes/skills/ pour voir ce que l'agent a appris. Les compétences sont stockées sous forme de fichiers JSON et peuvent être modifiées manuellement si vous voulez les ajuster.

Changer de modèle depuis la CLI

Vous n'avez pas besoin de modifier le fichier de config à chaque fois. Hermes Agent intègre des commandes pour ça :

# List available models for your current provider
hermes model list

# Switch to a specific model
hermes model set meta-llama/llama-3.3-70b-instruct:free

# Check what model you're currently using
hermes model show

Vérification de l'état

Lancez ça après chaque modification de configuration pour vérifier que tout est bien connecté :

hermes doctor

Il vérifie votre clé API, la disponibilité du modèle, la connectivité réseau et l'état du système de compétences. Si quelque chose ne va pas, il vous dit exactement quoi corriger.

Lancer votre première session

Une fois configuré, lancez une session :

hermes chat

Ça ouvre un REPL interactif. Essayez quelque chose de simple d'abord :

You: What tools do you have available?
Hermes: I have access to 47 built-in tools including:
- file_read / file_write (file operations)
- shell_exec (run shell commands)
- web_search / web_fetch (web access)
- code_search (search codebases)
- calendar / reminders (scheduling)
- ...and more. I can also use MCP tools if configured.

Ensuite, donnez-lui une vraie tâche :

You: Create a Python script that monitors a directory for new files and logs their names to a file called new_files.log

Hermes: I'll create that for you.
[creates watch_dir.py with inotify or polling-based implementation]
[tests the script]
The script is ready at ./watch_dir.py. Run it with python watch_dir.py /path/to/watch

La première fois que vous demandez quelque chose, l'agent construit la compétence de zéro. Redemandez quelque chose de similaire plus tard, et il réutilisera la version affinée. Vous pouvez le voir en action en consultant le répertoire de compétences après quelques sessions.

Connexion aux plateformes de messagerie

Une des fonctionnalités phares de Hermes Agent est la prise en charge des plateformes. Vous pouvez communiquer avec lui via plus de 15 plateformes de messagerie, pas seulement en CLI.

Configuration Telegram

1. Envoyez un message à @BotFather sur Telegram pour créer un nouveau bot
2. Copiez le token du bot
3. Ajoutez-le à votre configuration :

hermes gateway add telegram --token "YOUR_BOT_TOKEN"

4. Lancez la passerelle :

hermes gateway start telegram

Vous pouvez maintenant discuter avec votre agent directement sur Telegram. Il conserve la même mémoire et les mêmes compétences que vos sessions CLI.

Configuration Discord

1. Créez un bot dans le Portail Développeur Discord
2. Activez le Message Content Intent
3. Copiez le token du bot
4. Configurez :

hermes gateway add discord --token "YOUR_BOT_TOKEN"
hermes gateway start discord

Autres plateformes prises en charge

Le même schéma s'applique à toutes les plateformes. Utilisez hermes gateway add <plateforme> avec les identifiants requis :

• Slack : Nécessite une Slack App avec les scopes bot
• WhatsApp : Utilise la WhatsApp Business API ou un pont non officiel
• Signal : Nécessite la configuration de signal-cli
• Matrix : Nécessite un compte de bot Matrix
• Mattermost : Jeton d'accès personnel
• Email : Identifiants IMAP/SMTP
• SMS : Twilio ou un fournisseur similaire
• DingTalk / Feishu / WeCom : Pour les plateformes de messagerie chinoises

Lancez hermes gateway list pour voir toutes les plateformes disponibles et leur statut.

Fonctionnalités clés à connaître

Hub de compétences

Hermes Agent possède un dépôt communautaire de compétences. Parcourez et installez des compétences créées par d'autres :

# Browse available community skills
hermes skills browse

# Install a specific skill
hermes skills install web-scraper

# List your installed skills
hermes skills list

C'est utile si vous ne voulez pas attendre que l'agent apprenne de zéro. Quelqu'un a probablement déjà créé une compétence pour les tâches courantes comme le scraping web, les tests d'API ou l'analyse de documents.

Planification cron

Configurez des tâches récurrentes sans cron externe :

hermes cron add "0 9 * * *" "Summarize yesterday's git commits and post to #dev-channel"

L'agent gère la planification en interne et utilise ses compétences pour exécuter la tâche.

Mode vocal

Si vous voulez rester les mains libres :

hermes chat --voice

Cela utilise le micro et les haut-parleurs de votre système. Ça fonctionne mieux avec les modèles qui gèrent l'entrée audio, bien qu'il puisse aussi utiliser un module local de reconnaissance vocale.

Délégation à des sous-agents

Pour les tâches complexes en plusieurs étapes, Hermes Agent peut créer des sous-agents :

You: Research the top 5 VPS providers, compare their pricing, and create a summary document

Hermes: I'll delegate this to subagents for parallel research.
[spawns subagents for each provider]
[collects results]
[generates comparison document]

Les sous-agents partagent la mémoire et le système de compétences de l'agent parent, ils bénéficient donc de tout ce que l'agent principal a appris.

Dépannage

« command not found: hermes »

Le script d'installation ajoute Hermes à votre PATH, mais votre shell actuel ne l'a peut-être pas détecté. Correction :

source ~/.bashrc  # or ~/.zshrc

Si ça ne fonctionne pas, vérifiez si ~/.local/bin/hermes existe et ajoutez-le manuellement à votre PATH :

export PATH="$HOME/.local/bin:$PATH"

Erreurs de clé API

Lancez hermes doctor en premier. Il vous dira si votre clé API est invalide, expirée ou si le modèle sélectionné n'est pas disponible. Corrections courantes :

• Pour OpenRouter : Vérifiez votre clé sur openrouter.ai/keys
• Les modèles gratuits ont parfois des limites de débit — essayez un autre modèle gratuit
• Assurez-vous qu'il n'y a pas d'espace en fin de votre clé API

Le modèle ne répond pas

Les modèles du plan gratuit ont des limites d'utilisation. Si vous en atteignez une :

hermes model list    # see what's available
hermes model set <different-free-model>  # switch

Utilisation mémoire élevée

Si la mémoire de l'agent devient trop volumineuse (vérifiez avec du -sh ~/.hermes/memory/), vous pouvez nettoyer les anciennes entrées :

hermes memory prune --older-than 30d

Cela conserve les interactions et compétences récentes mais supprime les journaux de conversation de plus de 30 jours.

Problèmes de connexion à la passerelle

Pour les plateformes de messagerie, assurez-vous que le processus de passerelle tourne :

hermes gateway status

Si une passerelle se déconnecte sans cesse, vérifiez votre réseau et redémarrez-la :

hermes gateway restart telegram

Pour conclure

Hermes Agent fait quelque chose que je n'ai pas vu d'autres agents open source réussir : il apprend réellement de vos habitudes d'utilisation et s'améliore au fil du temps, sans que vous ayez besoin de définir manuellement des flux de travail ou d'écrire des plugins personnalisés. Le système de compétences est le vrai différenciateur — des tâches qui prennent 10 minutes la première fois prennent 30 secondes la cinquième fois.

Le fait qu'il tourne sur du matériel bon marché et se connecte à des fournisseurs de modèles gratuits signifie que vous pouvez avoir un agent IA personnel qui tourne 24/7 pour un coût quasi nul. Branchez-le sur Telegram ou Discord, et vous aurez un assistant toujours disponible qui se souvient de vos préférences, de votre codebase et de vos flux de travail.

Pour commencer :

1. Choisissez un VPS (ou utilisez votre machine locale) — LightNode fonctionne très bien pour ça
2. Lancez l'installateur en une ligne
3. Inscrivez-vous sur OpenRouter et récupérez un modèle gratuit
4. Commencez à discuter

Le repo GitHub a une documentation détaillée, et la communauté est active si vous rencontrez des problèmes. Donnez-lui un week-end — lundi, vous aurez un agent qui a déjà commencé à construire des compétences spécifiques à votre travail.