Comment installer Hermes Agent : guide de configuration pour débutants

Q: Que dois-je faire après avoir installé Hermes Agent ?

Exécutez `hermes model`, choisissez un fournisseur, comme Kimi, lancez `hermes`, testez une conversation normale, exécutez `hermes doctor`, puis vérifiez que `hermes --continue` reprend bien votre session. Ensuite, ajoutez si besoin l'isolation Docker, des compétences, des serveurs MCP, la voix, cron ou une passerelle de messagerie.

Découvrez comment installer Hermes Agent sur macOS et Windows. Suivez des commandes adaptées aux débutants, les étapes de configuration du modèle, les vérifications et les solutions de dépannage.

Configuration avec l'API Kimi

10 min de lecture2026-07-13

Comment installer l'outil d'agent Hermes

Hermes Agent est un agent d'IA open source développé par Nous Research qui s'exécute depuis votre terminal, se connecte à différents fournisseurs de modèles, conserve le contexte utile d'une session à l'autre, et peut être étendu avec des outils, des compétences, des passerelles de messagerie et de l'automatisation. Ce guide vous explique comment installer Hermes. Vous n'avez pas besoin d'installer manuellement Python ou Node.js pour l'installateur standard sur macOS ou Windows, car l'installateur officiel se charge des principales dépendances.

Avant d'installer Hermes Agent

Hermes Agent est un logiciel conçu avant tout pour le terminal, vous devrez donc l'installer depuis une ligne de commande. Choisissez la section correspondant à votre ordinateur :

macOS : ouvrez le Terminal depuis Applications > Utilitaires > Terminal, ou appuyez sur Commande + Espace et recherchez « Terminal ».
Windows : installez d'abord WSL2, ouvrez le terminal de votre distribution Linux, puis suivez la commande Linux.

Vous avez également besoin de Git. Vérifiez si Git est installé :

git --version

Résultat attendu :

git version 2.x.x

Si vous voyez git: command not found, installez d'abord Git :

# Ubuntu / Debian / WSL2 sudo apt update sudo apt install -y git

# macOS with Homebrew brew install git

Si vous n'avez pas Homebrew sur macOS, installez Git via les outils en ligne de commande d'Apple en exécutant :

xcode-select --install

Étape 1 : Installer Hermes Agent sur macOS ou Windows

Dans votre terminal, copiez et collez la commande d'installation officielle :

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

Installer l'assistant Hermes Agent avec la commande d'installation officielle

L'installateur télécharge Hermes Agent, prépare son environnement Python, installe les dépendances requises et ajoute la commande hermes à votre PATH de shell. Pour une installation utilisateur normale, les données de Hermes sont stockées dans ~/.hermes/.

Une fois la commande terminée, rechargez votre shell :

source ~/.bashrc

Si vous utilisez Zsh, courant sur macOS, exécutez :

source ~/.zshrc

Résultat attendu :

# No error output

Vérifiez maintenant que la commande Hermes Agent est disponible :

hermes --version

Résultat attendu :

hermes, version ...

Le numéro de version exact peut changer au fil des mises à jour de Hermes Agent.

Étape 2 : Configurer votre fournisseur de modèle

Hermes Agent a besoin d'un fournisseur de modèle avant de pouvoir répondre ou utiliser des outils. La configuration la plus simple pour débuter est interactive :

hermes model

L'assistant vous permet de choisir un fournisseur tel que Kimi/Moonshot. Ne configurez pas le routage, le repli, la passerelle ou le cron tant qu'un chat basique ne fonctionne pas.

Choisir un fournisseur LLM pour l'outil Hermes agent

Sélectionnez le modèle par défaut. kimi-k2.6 est à ce jour le modèle le plus avancé de Kimi.

Si vous connaissez déjà la valeur que vous souhaitez définir, vous pouvez utiliser hermes config set. Par exemple :

hermes config set Moonshot_API_KEY sk-or-your-key-here

Si vous n'avez pas de clé API, Kimi peut être un choix intéressant.

Étape 1 : Activer votre clé API Kimi

Avant d'utiliser l'API Kimi avec Hermes Agent, activez votre clé API Kimi sur le Kimi Platform. Nous recommandons 20 $ ou plus pour débloquer l'accès de niveau 2, qui réduit la latence et offre des performances plus stables pour les tâches complexes en plusieurs étapes

Configuration avec l'API Kimi

Étape 2 : Créer votre clé API Kimi

Rendez-vous dans la section Clés API du Kimi Platform et cliquez sur Créer une clé API. Pensez à copier votre clé API et à la conserver en lieu sûr, car elle n'est affichée qu'une seule fois lors de sa création.

Étape 3 : Saisir votre clé API

Collez votre clé API Kimi et connectez Hermes Agent.

Étape 3 : Démarrer Hermes Agent

Une fois le modèle configuré, lancez la CLI classique :

hermes

Ou essayez la nouvelle interface terminal :

hermes --tui

Vous devriez voir un écran d'accueil ou une invite affichant le fournisseur/modèle sélectionné. Testez-le avec une requête simple :

Vérifie mon répertoire actuel et dis-moi quels fichiers tu vois.

Voici à quoi ressemble une réussite :

Hermes répond sans erreur d'authentification. Hermes peut lire ou raisonner sur le répertoire actuel. La session se poursuit après la première réponse.

Si Hermes Agent s'ouvre mais répond avec des erreurs de modèle ou d'authentification, exécutez :

hermes model

Choisissez ensuite à nouveau votre fournisseur et vérifiez la clé API ou la connexion OAuth.

Étape 4 : transformer Hermes Agent en bot

Comme OpenClaw, Hermes Agent peut aussi agir comme un bot et se connecter à vos applications de chat :

hermes gateway setup

Une fois la configuration terminée, vérifiez l'état de la passerelle :

hermes gateway status

N'utilisez la passerelle qu'une fois que votre fournisseur de modèle fonctionne dans le terminal. Si le CLI ne parvient pas à finaliser une simple conversation, le bot échouera généralement pour la même raison.

Problèmes courants d'installation de Hermes Agent

`hermes: command not found`

Cause : votre terminal n'a pas encore rechargé la modification du PATH.

Solution :

source ~/.bashrc

Ou :

source ~/.zshrc

Essayez ensuite :

hermes --version

`git: command not found`

Cause : Git est manquant.

Solution sous Ubuntu, Debian ou WSL2 :

sudo apt update sudo apt install -y git

Solution sous macOS avec Homebrew :

brew install git

Clé API non configurée

Cause : Hermes Agent est installé, mais aucune clé de fournisseur ni connexion n'est configurée.

Solution :

hermes model

Ou définissez une clé manuellement :

hermes config set OPENROUTER_API_KEY sk-or-your-key-here

`hermes doctor` signale une configuration manquante ou obsolète

Cause : votre fichier de configuration peut être incomplet après une mise à jour.

Solution :

hermes config check hermes config migrate hermes doctor

Le point de terminaison personnalisé se connecte mais donne de mauvaises réponses

Cause : l'URL de base, le nom du modèle ou la longueur de contexte est incorrect.

Solution : testez d'abord le point de terminaison dans un client séparé, vérifiez qu'il est compatible OpenAI, et assurez-vous que le modèle prend en charge au moins 64K de contexte pour les flux de travail Hermes Agent classiques.

Référence rapide des commandes

Conclusion

La façon la plus simple d'installer Hermes Agent consiste à utiliser l'installateur officiel en une ligne, à recharger votre shell, à exécuter hermes model, puis à vérifier la configuration avec une véritable conversation et hermes doctor. Gardez votre première configuration simple : une machine, un fournisseur, une conversation qui fonctionne. Une fois l'assistant Hermes Agent de base stable, vous pouvez ensuite le développer en toute sécurité avec l'isolation Docker, des bots de passerelle, des compétences, des automatisations planifiées et des fournisseurs de modèles personnalisés.

FAQ

Qu'est-ce que Hermes Agent ?

Hermes Agent est une plateforme d'agent IA open source développée par Nous Research. Elle s'exécute depuis le terminal, prend en charge de nombreux fournisseurs de modèles, utilise des outils, stocke sa configuration sous ~/.hermes/, et peut être étendue avec des compétences, une mémoire, des tâches planifiées et des passerelles de messagerie.

Hermes Agent est-il un logiciel ou une application web ?

Hermes Agent est un logiciel que vous installez localement, sur WSL2, sur un serveur ou dans des environnements pris en charge comme Termux. Ce n'est pas seulement une application web hébergée. De nombreux utilisateurs l'exploitent comme assistant IA en ligne de commande ou comme agent fonctionnant en permanence sur un VPS.

Ai-je besoin de Python ou de Node.js avant d'installer Hermes Agent ?

Avec l'installateur officiel, vous n'avez généralement pas besoin d'installer Python ou Node.js manuellement. L'installateur gère les dépendances principales. Vous devez d'abord vous assurer que Git est disponible.

Puis-je utiliser Hermes Agent sur Windows ?

Oui. La méthode recommandée pour les débutants est WSL2. Une prise en charge native de Windows existe, mais la documentation officielle la classe comme bêta précoce : attendez-vous donc à plus d'aspérités que sur le parcours Linux/macOS/WSL2.

Que dois-je faire après avoir installé Hermes Agent ?

Exécutez hermes model, choisissez un fournisseur, comme Kimi, lancez hermes, testez une conversation normale, exécutez hermes doctor, puis vérifiez que hermes --continue reprend bien votre session. Ensuite, ajoutez si besoin l'isolation Docker, des compétences, des serveurs MCP, la voix, cron ou une passerelle de messagerie.