Hermes

Hermes est un agent open source de Nous Research. Son assistant intégré hermes model permet d’ajouter HiAPI comme endpoint personnalisé, sans outil de gestion tiers. Les étapes ci-dessous utilisent claude-opus-5-5 comme exemple ; ce tutoriel a été vérifié sous Windows avec Hermes 0.22.5.

1. Installer Hermes

1.1 Prérequis

1.2 Windows (PowerShell)

Ignorez l’assistant de configuration et ne configurez le modèle qu’après l’installation :

& ([scriptblock]::Create((irm https://hermes-agent.nousresearch.com/install.ps1))) -SkipSetup

Installation standard (ouvre l’assistant de configuration) :

iex(irm https://hermes-agent.nousresearch.com/install.ps1)

1.3 macOS / Linux

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --skip-setup

1.4 Vérifier l’installation

Rouvrez le terminal et exécutez :

hermes --version

Voir le numéro de version suffit ; continuez dès qu’il y a une sortie.

1.5 Autres méthodes d’installation

Le script d’installation et les exigences de version suivent la documentation officielle d’installation de Hermes.

2. Configurer l’endpoint HiAPI

Hermes dispose de deux commandes liées aux modèles, aux rôles différents ; ne les confondez pas :

Pour ajouter HiAPI, utilisez hermes model : quittez donc d’abord la session (Ctrl+C ou /quit).

2.1 Lancer l’assistant de configuration

hermes model

Choisissez Custom endpoint (self-hosted / VLLM / etc.) (certaines versions affichent Custom endpoint (enter URL manually)).

2.2 Renseigner chaque invite

Pour les modèles Claude, choisissez Anthropic Messages comme API compatibility mode. Avec claude-opus-5-5 comme exemple :

En mode Anthropic Messages, définissez l’API base URL sur l’adresse racine https://api.hiapi.ai sans /v1 ; Hermes ajoute /v1/messages lui-même. La clé API HiAPI est masquée ou affichée sous forme d’astérisques pendant la saisie ; collez-la et appuyez sur Entrée.

2.3 Connecter GPT, DeepSeek et d’autres modèles

Pour GPT, DeepSeek et d’autres modèles, renseignez les autres éléments comme dans le tableau ci-dessus, ne changez que les deux lignes ci-dessous, et remplacez Model name par le nom du modèle correspondant. Notez que l’adresse inclut ici /v1.

Les combinaisons testées pour ce tutoriel sont : Anthropic Messages pour Claude, Chat Completions pour GPT et DeepSeek. Si un modèle ne prend pas en charge le protocole choisi, vous obtenez une erreur 400.

2.4 Changer de modèle

Pour changer de modèle sous le même endpoint, tapez ceci directement dans une session :

/model custom:<model-id>

Ou relancez hermes model pour changer le modèle par défaut. Pour passer à un autre modèle, trouvez le nom du modèle dans la liste des modèles texte et vérifiez que son contexte fait au moins 64K. D’autres options pour les endpoints personnalisés figurent dans la documentation des endpoints personnalisés Hermes.

3. Configuration manuelle (facultatif)

La configuration manuelle ci-dessous fonctionne pour GPT, DeepSeek et les autres modèles qui utilisent Chat Completions ; pour Claude, utilisez l’assistant hermes model ci-dessus. Si vous ne pouvez pas utiliser l’assistant, modifiez directement ~/.hermes/config.yaml (base_url doit inclure /v1) :

model:
  default: <model-id>
  provider: custom
  base_url: https://api.hiapi.ai/v1
  api_key: YOUR_HIAPI_API_KEY

Vous pouvez aussi utiliser une variable d’environnement au lieu d’une clé en clair ; key_env indique comment Hermes lit une variable d’environnement, laissez-le tel quel :

model:
  default: <model-id>
  provider: custom
  base_url: https://api.hiapi.ai/v1
  key_env: HIAPI_API_KEY

Écrivez ensuite ceci dans ~/.hermes/.env :

HIAPI_API_KEY=YOUR_HIAPI_API_KEY

Remplacez YOUR_HIAPI_API_KEY par votre clé API HiAPI. Après avoir modifié la configuration, démarrez une nouvelle session avec /new ou redémarrez Hermes avant de tester.

4. Vérifier

4.1 Chat

Ouvrez Hermes, confirmez qu’il utilise le fournisseur HiAPI et envoyez « Bonjour, présentez-vous en une phrase. » Une réponse normale signifie que la connexion fonctionne.

4.2 Appel d’outils

Créez d’abord tool-call-test.txt dans le dossier depuis lequel vous démarrez Hermes, écrivez une ligne hello hiapi et enregistrez. Envoyez ensuite « N’appelez un outil qu’une seule fois. Lisez tout le contenu de tool-call-test.txt et renvoyez-le exactement tel quel. Ne devinez pas le contenu à partir du nom du fichier. » Vérifiez qu’un appel d’outil apparaît et renvoie hello hiapi.

5. Dépannage

Seuls les problèmes propres à Hermes sont listés ici. Pour les erreurs courantes comme 401, 404 et 429, voir Erreurs courantes.

Cette page ne couvre que les modèles texte ; pour les capacités d’outils, voir le guide MCP.