Antoine Laurent

Posted on Mar 30 • Originally published at apidog.com

Comment utiliser Hermes Agent

#agents #ai #opensource #tutorial

En bref : Hermes Agent est un assistant IA open-source qui apprend continuellement et conserve la mémoire de vos interactions pour devenir plus pertinent à chaque utilisation. Installez-le en une seule commande, configurez votre fournisseur de LLM, et commencez à l'utiliser depuis la CLI, Telegram, Discord, ou votre IDE. Ce guide détaille l'installation, la configuration, l'utilisation quotidienne, les fonctionnalités avancées et les astuces pour exploiter tout le potentiel d'Hermes.

Essayez Apidog dès aujourd'hui

Qu'est-ce que Hermes Agent ?

Hermes Agent est un assistant IA personnel développé par NousResearch fonctionnant 24h/24, 7j/7, qui retient tout ce qu'il apprend et améliore ses réponses avec le temps. Contrairement à ChatGPT ou Claude, qui oublient chaque conversation, Hermes construit une mémoire persistante de votre travail, vos projets et vos préférences.

Capacités clés :

Mémorise — Stocke conversations, décisions et code
Apprend — Génère des compétences réutilisables à partir de tâches fréquentes
Multi-plateforme — Utilisable depuis CLI, Telegram, Discord, Slack, WhatsApp ou IDE
Auto-hébergé — Fonctionne sur laptop, VPS à 5$ ou cloud
Indépendant du modèle — Plus de 200 modèles via OpenRouter ou autres fournisseurs
Extensible — Système de plugins pour outils et commandes personnalisés

Pour qui ?

Développeurs voulant un assistant IA intégré à leur codebase
Équipes cherchant un assistant IA partagé et multi-utilisateur
Utilisateurs avancés souhaitant automatiser des workflows par cron
Chercheurs entraînant des modèles IA personnalisés

Installation : Étape par étape

Prérequis

OS : macOS, Linux, ou Windows (WSL recommandé)
Python : 3.10+
Git : Pour cloner les dépôts
Clé API : OpenRouter, Anthropic, OpenAI, etc.

Installation rapide (recommandée)

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

Ce script va :

Cloner le repo Hermes
Installer uv (gestionnaire de paquets Python)
Créer un environnement virtuel
Installer les dépendances
Ajouter Hermes à votre PATH

Rechargez ensuite votre shell :

source ~/.bashrc  # bash
source ~/.zshrc   # zsh

Vérifiez l'installation :

hermes --version

Vous devez voir Hermes Agent v0.5.0 ou supérieur.

Installation manuelle (développeurs)

# Cloner le dépôt
git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

# Installer uv (si besoin)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Créer et activer l'env virtuel
uv venv venv --python 3.11
source venv/bin/activate  # Linux/macOS
# ou
.\venv\Scripts\activate  # Windows

# Installer Hermes avec toutes les options
uv pip install -e ".[all,dev]"

# Exécuter les tests d'installation
python -m pytest tests/ -q

Installation avec support d'entraînement RL

# Initialiser le sous-module Atropos
git submodule update --init tinker-atropos

# Installer les dépendances d'entraînement
uv pip install -e "./tinker-atropos"

Configuration initiale

Exécutez l'assistant de configuration

hermes setup

L'assistant vous guide sur :

Choix du fournisseur LLM
Ajout des clés API (stockées dans ~/.hermes/.env)
Activation de la mémoire persistante
Choix du backend terminal (local, Docker, SSH, cloud)
Intégrations passerelles (Telegram, Discord, Slack)

Configuration manuelle

Modifiez la config directement :

hermes config edit

Ou via CLI :

# Définir le modèle par défaut
hermes config set model anthropic/claude-opus-4

# Définir le backend terminal
hermes config set terminal.backend local

# Définir les clés API
hermes config set OPENROUTER_API_KEY sk-or-...
hermes config set ANTHROPIC_API_KEY sk-ant-...

Emplacement du fichier de configuration

~/.hermes/
├── config.yaml      # Config principale
├── .env             # Clés API (privées)
├── memory/          # Mémoire persistante
├── skills/          # Compétences personnalisées
└── plugins/         # Plugins

Vérifiez votre configuration

hermes doctor

Validité de la config
Connectivité API
État mémoire
État passerelle
Backend terminal

Choisir votre fournisseur de LLM

Hermes supporte plus de 200 modèles via plusieurs fournisseurs.

OpenRouter (débutants recommandé)

Avantage : Une seule clé API pour 200+ modèles. Tier gratuit.

hermes config set model openrouter
hermes config set OPENROUTER_API_KEY sk-or-...

Modèles populaires OpenRouter :

Modèle	Cas d'utilisation	Coût
`anthropic/claude-opus-4`	Codage complexe, raisonnement	$$$
`anthropic/claude-sonnet-4`	Performances équilibrées	$$
`openai/gpt-4o`	Usage général	$$
`google/gemini-pro-1.5`	Fenêtres contextuelles longues	$
`meta/llama-3-70b`	Open source, rapide	$

Anthropic Direct

hermes config set model anthropic
hermes config set ANTHROPIC_API_KEY sk-ant-...
hermes config set model.default claude-opus-4

OpenAI Direct

hermes config set model openai
hermes config set OPENAI_API_KEY sk-...

Modèles locaux (Ollama)

# Installez Ollama : https://ollama.ai
hermes config set model ollama
hermes config set model.default qwen2.5-coder:32b

Exemples de configuration de modèle

Routage intelligent :

model:
  provider: openrouter
  default: anthropic/claude-opus-4
  fallback:
    - anthropic/claude-haiku-4-5
    - openai/gpt-4o-mini

Contrôle des coûts :

model:
  budget:
    daily_limit: 5.00  # USD
    monthly_limit: 100.00

Utilisation de base : Mode CLI

Démarrer Hermes

hermes

Une bannière s'affiche, vous pouvez discuter immédiatement.

Commandes de base

Discussion naturelle :

> Salut, peux-tu m'aider à écrire une fonction Python pour analyser du JSON ?

Commandes slash :

> /help
> /skills
> /memory
> /config
> /clear
> /history

Tâches sur fichier :

> Regarde le fichier ./src/main.py et refactorise la connexion à la base de données

Exécution de commandes terminal :

> Run: npm install && npm run build

Hermes demande toujours confirmation avant exécution.

Shell persistant

> cd /my/project && source venv/bin/activate
> python src/main.py  # Même session shell

Le venv reste actif pour les prochaines commandes.

Travailler avec des fichiers

Lire :

> Montre-moi le contenu de config.yaml

Modifier :

> Dans main.py, change le port de la base de données de 5432 à 5433

Créer :

> Crée un nouveau fichier appelé utils.py avec des fonctions utilitaires pour le formatage des dates

Flux de travail multi-étapes

> Je dois ajouter l'authentification utilisateur à mon application Flask. Peux-tu :
> 1. Configurer les modèles de base de données
> 2. Créer des points d'accès de connexion/déconnexion
> 3. Ajouter la génération de jetons JWT
> 4. Écrire des tests pour le flux d'authentification

Hermes traite chaque étape et demande confirmation.

Passerelle de messagerie : Telegram, Discord, Slack

Hermes fonctionne comme bot sur plusieurs plateformes, accessible depuis mobile ou discussions d'équipe.

Configuration de Telegram

Ouvrez Telegram, cherchez @botfather
Envoyez /newbot et copiez le token

hermes config set TELEGRAM_BOT_TOKEN 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
hermes gateway setup telegram
hermes gateway start

Trouvez votre bot, envoyez /start, discutez comme en CLI

Configuration de Discord

Créez une app sur https://discord.com/developers/applications
Ajoutez un bot, copiez le token
Invitez le bot via OAuth2 → URL Generator

hermes config set DISCORD_BOT_TOKEN MTIzNDU2...
hermes gateway setup discord
hermes gateway start

Mentionnez le bot ou utilisez-le en privé

Configuration de Slack

Créez une app sur https://api.slack.com/apps
Ajoutez les permissions "Bot"
Installez et copiez le token

hermes config set SLACK_BOT_TOKEN xoxb-...
hermes gateway setup slack
hermes gateway start

Utilisation multi-plateforme

hermes gateway start --all

Hermes synchronise les conversations sur toutes les plateformes.

Intégration IDE : VS Code, JetBrains

Hermes s'intègre à votre éditeur via le protocole ACP.

Intégration VS Code

Ouvrez VS Code > Extensions
Recherchez "Agent Communication Protocol"
Installez l'extension

hermes acp start

Ouvrez la barre latérale ACP, sélection Hermes, utilisez-le dans l'éditeur

Intégration JetBrains (IntelliJ, PyCharm...)

Ouvrez Paramètres → Plugins → "ACP"
Installez et redémarrez l'IDE

hermes acp start

Paramètres → Outils → Agents IA, ajoutez Hermes comme backend ACP

Éditeur Zed

{
  "agent": {
    "provider": "acp",
    "endpoint": "hermes"
  }
}
hermes acp start

Système de mémoire et d'apprentissage

La mémoire d'Hermes est au cœur de ses super-pouvoirs.

Types de mémoire

Épisodique : Conversations/sessions spécifiques (recherche possible).

> /memory search "migration de base de données"

Sémantique : Graphes de connaissances sur projets, préférences.

> /memory projects

Procédurale (Compétences) : Stocke des workflows réutilisables.

> /skills list

Recherche de session

> /memory search "Comment avons-nous géré l'expiration du JWT la semaine dernière ?"

Incitateurs de mémoire

[Hermes] : J'ai remarqué que vous travaillez sur le système d'authentification. Mardi dernier, vous avez mentionné un problème avec l'expiration du JWT. Voulez-vous y revenir ?

Compression du contexte

Compression automatique à 85% du contexte
Compression agent à 50% (configurable)

Exporter et sauvegarder

hermes memory export ~/backup/hermes-memory.json
hermes memory import ~/backup/hermes-memory.json

Compétences et plugins

Que sont les compétences ?

Compétences = workflows réutilisables (macros IA).

code_review — Analyse de code
debug_session — Débogage
api_tester — Test API REST/GraphQL
git_workflow — Opérations Git
documentation — Génération de docs

Parcourir et installer des compétences

> /skills list
> /skills install code_review
> /skills run code_review ./src/auth.py

Compétences personnalisées

# ~/.hermes/skills/my_skill.py
from hermes.skills import Skill

class MyCustomSkill(Skill):
    name = "my_custom_skill"
    description = "Fait quelque chose d'utile"

    def execute(self, context):
        # Votre logique ici
        return "Compétence exécutée avec succès"

Système de plugins

# ~/.hermes/plugins/my_tool.py
from hermes.tools import Tool

class MyCustomTool(Tool):
    name = "my_tool"
    description = "Un outil personnalisé pour des tâches spécifiques"

    def run(self, **kwargs):
        return {"result": "succès"}

Outils : Nouvelles capacités IA
Commandes : Nouvelles commandes slash
Hooks : Hooks cycle de vie IA

Fonctionnalités avancées

Planification Cron

# Demander à Hermes de planifier une tâche
> Mets en place un résumé quotidien de mes notifications GitHub à 9h du matin

cron:
  - name: "Résumé quotidien"
    schedule: "0 9 * * *"
    command: "/skills run github_digest"
    model: "anthropic/claude-haiku-4-5"

Délégation de sous-agents

> J'ai besoin que tu révises toutes les PRs de mon dépôt et que tu résumes les changements

Mode vocal

hermes --voice

Envoyez des notes vocales (Telegram/Discord), transcription automatique
Hermes peut rejoindre les salons vocaux Discord

Contrôle du navigateur

> Va sur github.com et trouve les 5 dépôts Python les plus populaires
hermes browser connect --cdp

Intégration MCP

mcp:
  servers:
    filesystem:
      command: "npx"
      args: ["-y", "@modelcontextprotocol/server-filesystem", "~/projects"]
    git:
      command: "npx"
      args: ["-y", "@modelcontextprotocol/server-git"]

Mode Worktree

hermes -w

Exécuter d'autres agents IA dans Hermes

> Utilise claude-code pour réviser cette pull request

Dépannage

Problèmes courants

"Clé API introuvable"

hermes config get OPENROUTER_API_KEY
hermes config set OPENROUTER_API_KEY sk-or-...

"Modèle non disponible"

hermes models list
hermes config set model anthropic/claude-opus-4

"Échec du démarrage de la passerelle"

hermes gateway status
hermes gateway stop
hermes gateway start

"Corruption de la mémoire détectée"

hermes memory export ~/backup/memory-backup.json
hermes memory reset
hermes memory import ~/backup/memory-backup.json

Obtenir de l'aide

> /help
hermes logs tail --follow
hermes doctor

FAQ

Combien coûte l'exécution d'Hermes ?

Usage léger : 5–15$/mois (OpenRouter)
Usage modéré : 20–50$/mois
Usage intensif : 50–200$/mois

Les modèles locaux (Ollama) sont gratuits mais nécessitent du hardware.

Hermes peut-il fonctionner 24h/24 et 7j/7 ?

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

Hermes convient-il à une utilisation en entreprise ?

Passerelle multi-utilisateur
Rédaction PII
Sécurité supply chain renforcée
Déploiement auto-hébergé
Journalisation d'audit

Comment migrer depuis OpenClaw ?

hermes claw migrate --dry-run
hermes claw migrate
hermes doctor

Puis-je utiliser Hermes sans internet ?

curl -fsSL https://ollama.ai/install.sh | sh
ollama pull qwen2.5-coder:32b
hermes config set model ollama
hermes config set model.default qwen2.5-coder:32b

Quelle est la différence entre Hermes et ChatGPT ?

Fonctionnalité	Hermes	ChatGPT
Mémoire	Persistante, consultable	Limitée à la session
Déploiement	Auto-hébergé, 24/7	Uniquement cloud
Choix du modèle	Plus de 200 modèles	Uniquement GPT
Extensibilité	Plugins, compétences	Limitée
Coût	Paiement à l'utilisation uniquement	Abonnement
Confidentialité	Vous contrôlez les données	OpenAI stocke les données

Comment sauvegarder mes données Hermes ?

hermes export --all ~/backup/hermes-full-backup.tar.gz

Hermes peut-il accéder à mes fichiers locaux ?

Hermes n'accède qu'aux fichiers explicitement référencés ou aux répertoires autorisés. Aucun accès système par défaut.

💡Vous voulez tester les API dans le cadre de votre flux de travail de développement basé sur l'IA ? Découvrez Apidog, la plateforme tout-en-un de développement API pour concevoir, tester et documenter les API.