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

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

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

• macOS : ouvrez 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é :

Résultat attendu :

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

Si vous n'avez pas Homebrew sur macOS, installez Git à partir des outils en ligne de commande Apple en exécutant :

Dans votre terminal, copiez et collez la commande de l'installateur officiel :

L'installateur télécharge Hermes Agent, prépare son environnement Python, installe les dépendances requises et ajoute la commande hermes au chemin de votre shell. Dans le cadre d'une installation utilisateur standard, les données Hermes sont stockées dans ~/.hermes/.

Lorsque la commande est terminée, rechargez votre shell :

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

Résultat attendu :

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

Résultat attendu :

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

Hermes Agent a besoin d'un fournisseur de modèles pour pouvoir répondre ou utiliser des outils. Pour les débutants, la configuration interactive est la plus simple :

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

Sélectionnez le modèle par défaut. Kimi K3 est le dernier modèle phare de Kimi ; si votre priorité est le code, kimi-k2.7-code est un meilleur choix.

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

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

Accédez à la section API Keys de Kimi Platform, puis cliquez sur Create API Key. 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.

Collez votre clé API Kimi et connectez Hermes Agent.

Une fois le modèle configuré, lancez l’interface CLI classique :

Ou essayez la nouvelle interface utilisateur du terminal :

Vous devriez voir un écran d’accueil ou une invite indiquant le fournisseur et le modèle sélectionnés. Testez-les avec une requête simple :

Voici à quoi ressemble une configuration réussie :

Si Hermes Agent s’ouvre mais renvoie des erreurs de modèle ou d’authentification, exécutez :

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

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

Après la configuration, vérifiez l’état de la passerelle :

N’utilisez la passerelle qu’une fois que votre fournisseur de modèles fonctionne dans le terminal. Si l’interface CLI ne peut pas effectuer une conversation de base, le bot échouera généralement pour la même raison.

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

Correctif :

Ou :

Essayez ensuite :

Cause : Git est absent.

Correctif sous Ubuntu, Debian ou WSL2 :

Correctif sous macOS avec Homebrew :

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

Correctif :

Ou définissez une clé manuellement :

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

Correctif :

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

Correctif : testez d’abord l’endpoint dans un client distinct, vérifiez qu’il est compatible avec OpenAI et assurez-vous que le modèle prend en charge au moins 64K de contexte pour les flux de travail Hermes Agent habituels.

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 vraie conversation et hermes doctor. Pour votre première configuration, restez simple : une machine, un fournisseur, une conversation fonctionnelle. Une fois l’assistant Hermes Agent de base stable, vous pourrez l’enrichir 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.