Blog

Comment utiliser Hermes Agent

Ashley Innocent

Ashley Innocent

30 March 2026

Comment utiliser Hermes Agent

En bref : Hermes Agent est un assistant IA open-source qui mémorise ce qu'il apprend et devient plus intelligent avec le temps. Installez-le avec une seule commande, configurez votre fournisseur de LLM, et commencez à discuter via CLI, Telegram, Discord ou votre IDE. Ce guide couvre l'installation, la configuration, l'utilisation quotidienne, les fonctionnalités avancées et comment tirer le meilleur parti d'Hermes.

bouton

Qu'est-ce que Hermes Agent ?

Hermes Agent est un assistant IA personnel développé par NousResearch qui fonctionne 24h/24 et 7j/7, mémorise tout ce qu'il apprend et devient plus performant avec le temps. Contrairement à ChatGPT ou Claude qui repartent de zéro à chaque conversation, Hermes construit un modèle persistant de votre travail, de vos projets et de vos préférences.

Image montrant le logo Hermes Agent et les plateformes compatibles

Capacités clés :

Qui devrait utiliser Hermes :

Installation : Étape par étape

Prérequis

Installation rapide (Recommandée)

Le moyen le plus rapide d'installer Hermes :

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

Ce script :

  1. Clone le dépôt Hermes
  2. Installe uv (gestionnaire de paquets Python rapide)
  3. Crée un environnement virtuel
  4. Installe toutes les dépendances
  5. Ajoute Hermes à votre PATH

Après l'installation, rechargez votre shell :

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

Vérifiez l'installation :

hermes --version

Vous devriez voir quelque chose comme Hermes Agent v0.5.0.

Installation manuelle (Pour les développeurs)

Si vous souhaitez plus de contrôle sur l'installation :

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

# Installez uv (si ce n'est pas déjà fait)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Créez et activez l'environnement virtuel
uv venv venv --python 3.11
source venv/bin/activate  # Linux/macOS
# ou
.\venv\Scripts\activate  # Windows

# Installez Hermes avec toutes les fonctionnalités
uv pip install -e ".[all,dev]"

# Exécutez les tests pour vérifier l'installation
python -m pytest tests/ -q

Installation avec support d'entraînement RL

Si vous prévoyez d'entraîner des modèles personnalisés :

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

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

Configuration initiale

Exécutez l'assistant de configuration

Les nouveaux utilisateurs doivent exécuter la configuration interactive :

hermes setup

L'assistant vous guidera à travers :

  1. Le choix de votre fournisseur de LLM — OpenRouter, Anthropic, OpenAI, etc.
  2. La configuration des clés API — Stockées en toute sécurité dans ~/.hermes/.env
  3. La configuration de la mémoire — Activer/désactiver la mémoire persistante
  4. Le backend du terminal — Options locales, Docker, SSH ou cloud
  5. La configuration de la passerelle — Intégration Telegram, Discord, Slack (facultatif)

Configuration manuelle

Si vous préférez la configuration manuelle, modifiez le fichier de configuration :

hermes config edit

Ou utilisez les commandes CLI :

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

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

# Définir les clés API (sauvegarde automatique dans ~/.hermes/.env)
hermes config set OPENROUTER_API_KEY sk-or-...
hermes config set ANTHROPIC_API_KEY sk-ant-...

Emplacement du fichier de configuration

Hermes stocke la configuration dans ~/.hermes/ :

~/.hermes/
├── config.yaml      # Configuration principale
├── .env             # Clés API (ne pas partager !)
├── memory/          # Stockage de la mémoire persistante
├── skills/          # Compétences installées
└── plugins/         # Plugins personnalisés

Vérifiez votre configuration

Exécutez le contrôle de santé :

hermes doctor

Ceci vérifie :

Choisir votre fournisseur de LLM

Hermes prend en charge plus de 200 modèles via plusieurs fournisseurs. Voici comment choisir :

OpenRouter (Recommandé pour les débutants)

Pourquoi : Une seule clé API donne accès à plus de 200 modèles. Tier gratuit disponible.

Configuration :

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

Modèles populaires sur 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

Pourquoi : Le meilleur de sa catégorie pour le codage et le raisonnement. Accès direct aux derniers modèles Claude.

Configuration :

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

OpenAI Direct

Pourquoi : Modèles GPT-4o et o1 pour des cas d'utilisation spécifiques.

Configuration :

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

Modèles locaux (Ollama)

Pourquoi : Gratuit, privé, utilisable hors ligne.

Configuration :

# Installez Ollama d'abord : 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 (modèle coûteux pour les tâches complexes, bon marché pour les tâches simples) :

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

Contrôle des coûts (définir des limites de dépenses) :

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

Utilisation de base : Mode CLI

Démarrer Hermes

Le moyen le plus simple d'utiliser Hermes :

hermes

Vous verrez une bannière de bienvenue et pourrez commencer à discuter immédiatement.

Commandes de base

Dans Hermes, vous pouvez :

Discuter naturellement :

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

Utiliser des commandes slash :

> /help          # Afficher toutes les commandes
> /skills        # Parcourir les compétences disponibles
> /memory        # Afficher l'état de la mémoire
> /config        # Afficher/modifier la configuration
> /clear         # Effacer la conversation actuelle
> /history       # Afficher les conversations passées

Donner des tâches basées sur des fichiers :

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

Exécuter des commandes de terminal :

> Run: npm install && npm run build

Hermes demandera une confirmation avant d'exécuter toute commande.

Shell persistant

Contrairement à d'autres outils d'IA, Hermes maintient l'état du shell à travers les commandes :

> cd /my/project && source venv/bin/activate
> python src/main.py  # S'exécute dans la même session shell

L'environnement virtuel reste actif pour les commandes suivantes.

Travailler avec des fichiers

Lire des fichiers :

> Montre-moi le contenu de config.yaml

Modifier des fichiers :

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

Créer de nouveaux fichiers :

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

Flux de travail multi-étapes

Hermes excelle dans les tâches complexes et 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 traitera chaque étape, en demandant une confirmation en cours de route.

Passerelle de messagerie : Telegram, Discord, Slack

Hermes peut fonctionner comme un bot sur plusieurs plateformes de messagerie, afin que vous puissiez interagir avec lui depuis votre téléphone ou votre discussion d'équipe.

Configuration de Telegram

1. Créez un bot :

2. Configurez Hermes :

hermes config set TELEGRAM_BOT_TOKEN 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

3. Démarrez la passerelle :

hermes gateway setup telegram
hermes gateway start

4. Commencez à discuter :

Configuration de Discord

1. Créez une application Discord :

2. Invitez le bot sur votre serveur :

3. Configurez Hermes :

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

4. Utilisez dans Discord :

Configuration de Slack

1. Créez une application Slack :

2. Installez-la dans l'espace de travail et copiez le jeton

3. Configurez Hermes :

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

Utilisation multi-plateforme

Vous pouvez exécuter plusieurs passerelles simultanément :

hermes gateway start --all

Hermes synchronise l'état de la conversation sur toutes les plateformes.

Intégration IDE : VS Code, JetBrains

Hermes s'intègre directement à votre éditeur de code via le Protocole de Communication d'Agent (ACP).

Intégration VS Code

1. Installez l'extension ACP :

2. Configurez Hermes comme backend :

hermes acp start

3. Utilisez dans VS Code :

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

1. Installez le plugin ACP :

2. Démarrez le serveur ACP Hermes :

hermes acp start

3. Configurez dans JetBrains :

Éditeur Zed

Zed a un support ACP natif :

1. Configurez dans les paramètres de Zed :

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

2. Démarrez Hermes :

hermes acp start

Système de mémoire et d'apprentissage

Le super-pouvoir d'Hermes est son architecture de mémoire. Voici comment l'utiliser efficacement.

Types de mémoire

Mémoire épisodique : Stocke les conversations et sessions spécifiques. Vous pouvez rechercher et récupérer des interactions passées.

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

Mémoire sémantique : Construit des graphes de connaissances sur vos projets, préférences et schémas.

> /memory projects

Mémoire procédurale (Compétences) : Crée des compétences réutilisables à partir de tâches répétées.

> /skills list

Recherche de session

Trouvez des travaux passés pertinents avec la recherche sémantique :

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

Hermes recherche dans tout votre historique et résume les résultats.

Incitateurs de mémoire

Hermes fait remonter proactivement les informations pertinentes :

[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

Hermes compresse automatiquement le contexte pour éviter d'atteindre les limites :

Cela permet des conversations indéfinies sans gestion manuelle du contexte.

Exporter et sauvegarder

Exporter la mémoire :

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

Importer la mémoire :

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

Compétences et plugins

Que sont les compétences ?

Les compétences sont des flux de travail réutilisables qu'Hermes peut exécuter. Considérez-les comme des macros pour des tâches complexes.

Les compétences intégrées incluent :

Parcourir et installer des compétences

Afficher les compétences disponibles :

> /skills list

Installer une compétence :

> /skills install code_review

Utiliser une compétence :

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

Compétences personnalisées

Créez des compétences personnalisées dans ~/.hermes/skills/ :

# ~/.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 de compétence ici
        return "Compétence exécutée avec succès"

Système de plugins

Les plugins étendent Hermes avec des outils, des commandes et des hooks personnalisés.

Créer un plugin :

# ~/.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):
        # Logique de l'outil ici
        return {"result": "succès"}

Types de plugins :

Fonctionnalités avancées

Planification Cron

Planifiez des tâches automatisées :

# Demandez à Hermes de créer une tâche planifiée
> Mets en place un résumé quotidien de mes notifications GitHub à 9h du matin

Ou configurez manuellement dans config.yaml :

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

Hermes peut générer des sous-agents pour le travail parallèle :

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

Hermes générera plusieurs sous-agents pour travailler en parallèle, puis synthétisera les résultats.

Mode vocal

Appuyer-pour-parler dans la CLI :

hermes --voice

Notes vocales dans Telegram/Discord :

Canaux vocaux Discord :

Contrôle du navigateur

Hermes s'intègre à Browser Use CLI 2.0 pour l'automatisation web :

> Va sur github.com et trouve les 5 dépôts Python les plus populaires

Ou connectez-vous à Chrome en direct via CDP :

hermes browser connect --cdp

Intégration MCP

Hermes prend en charge les serveurs Model Context Protocol (MCP) :

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

Mode Worktree

Exécutez Hermes dans un worktree Git isolé :

hermes -w

Plusieurs agents peuvent travailler sur le même dépôt simultanément sans conflits.

Exécuter d'autres agents à l'intérieur d'Hermes

Hermes peut exécuter d'autres agents IA en tant que sous-agents :

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

Ceci est utile pour exploiter des agents spécialisés pour des tâches spécifiques.

Dépannage

Problèmes courants

"Clé API introuvable"

# Vérifiez si la clé API est définie
hermes config get OPENROUTER_API_KEY

# Réinitialisez si nécessaire
hermes config set OPENROUTER_API_KEY sk-or-...

"Modèle non disponible"

# Listez les modèles disponibles
hermes models list

# Changez le modèle
hermes config set model anthropic/claude-opus-4

"Échec du démarrage de la passerelle"

# Vérifiez l'état de la passerelle
hermes gateway status

# Redémarrez la passerelle
hermes gateway stop
hermes gateway start

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

# Sauvegardez la mémoire actuelle
hermes memory export ~/backup/memory-backup.json

# Réinitialisez la mémoire
hermes memory reset

# Réimportez si nécessaire
hermes memory import ~/backup/memory-backup.json

Obtenir de l'aide

Aide intégrée :

> /help

Afficher les journaux :

hermes logs tail --follow

Exécuter des diagnostics :

hermes doctor

FAQ

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

Hermes lui-même est gratuit. Vous ne payez que pour l'utilisation du LLM. Coûts typiques :

L'utilisation de modèles locaux (Ollama) est gratuite mais nécessite du matériel.

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

Oui. Déployez Hermes sur un VPS :

# Installez sur un VPS
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# Exécutez comme un service systemd
hermes service install
hermes service start

Hermes convient-il à une utilisation en entreprise ?

Oui. Les fonctionnalités d'entreprise incluent :

Comment migrer depuis OpenClaw ?

hermes claw migrate --dry-run  # Aperçu
hermes claw migrate            # Migration complète
hermes doctor                  # Vérifier

Puis-je utiliser Hermes sans internet ?

Oui, avec des modèles locaux :

# Installez Ollama
curl -fsSL https://ollama.ai/install.sh | sh

# Téléchargez un modèle
ollama pull qwen2.5-coder:32b

# Configurez Hermes
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 ?

# Exporter tout
hermes export --all ~/backup/hermes-full-backup.tar.gz

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

Hermes ne peut accéder qu'aux fichiers que vous référencez explicitement ou aux répertoires auxquels vous avez accordé la permission. Par défaut, il n'a aucun accès à votre système de fichiers.

💡
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.
bouton

Pratiquez le Design-first d'API dans Apidog

Découvrez une manière plus simple de créer et utiliser des API

S'inscrire gratuitementTélécharger