Skip to main content
Utilisez CometAPI comme fournisseur de modèle pour Hermes Agent. Hermes prend en charge deux chemins CometAPI dans ce guide : un endpoint général compatible OpenAI pour la plupart des modèles de texte et une route Claude via Anthropic Messages.

​
Prérequis

  • Git
  • Un compte CometAPI avec une clé API active
  • Un terminal sur macOS, Linux ou WSL2

​
Installation

1

Obtenez votre clé API CometAPI

Connectez-vous à la console CometAPI. Cliquez sur Add API Key et copiez votre clé API CometAPI.
Tableau de bord CometAPI montrant le bouton Add API Key
Détails de la clé API CometAPI avec l’URL de base affichée
2

Installez Hermes Agent

La commande suivante exécute l’installateur officiel :
Si le shell actuel ne reconnaît pas encore la commande hermes, rechargez la configuration du shell :
Hermes stocke la configuration dans ~/.hermes/, crée un lien vers la commande hermes dans ~/.local/bin, et peut ajouter ~/.local/bin au PATH de votre shell.

​
Configuration

Choisissez la route CometAPI qui correspond à la famille de modèles :
Ne configurez pas Hermes avec https://api.cometapi.com/v1beta comme fournisseur personnalisé Gemini natif. Utilisez la configuration Hermes compatible OpenAI pour les modèles Gemini. Pour les appels directs à l’API Gemini, utilisez l’API Gemini generateContent.
1

Stockez votre clé CometAPI

Ouvrez ~/.hermes/.env et ajoutez les valeurs suivantes :
COMETAPI_KEY est utilisée par le fournisseur Claude nommé. OPENAI_API_KEY permet au mécanisme de secours de point de terminaison personnalisé compatible OpenAI de Hermes de continuer à fonctionner.
2

Configurez la route compatible OpenAI

Utilisez cette route pour la plupart des modèles de texte CometAPI, y compris les modèles Gemini utilisés depuis Hermes. Ouvrez ~/.hermes/config.yaml et assurez-vous que la section model ressemble à ceci :
Remplacez your-model-id par un model ID de modèle de texte actuel depuis la page des modèles CometAPI.
Conservez la clé API dans ~/.hermes/.env. N’intégrez pas les secrets en dur dans config.yaml.
Cette configuration définit le modèle de chat principal. Hermes peut utiliser des modèles auxiliaires séparés pour des tâches telles que la vision ou l’extraction web.
3

Configurez la route Claude Messages

Utilisez cette route lorsque vous voulez que Hermes appelle des modèles Claude via Anthropic Messages. Ouvrez ~/.hermes/config.yaml et utilisez un fournisseur nommé :
Remplacez your-claude-model-id par un model ID Claude actuel depuis la page des modèles CometAPI.
Conservez base_url à https://api.cometapi.com pour cette route. Hermes utilise le transport Anthropic Messages depuis le fournisseur nommé.

​
Vérification

1

Vérifiez la configuration

La commande suivante confirme que Hermes peut lire la configuration et la clé API :
Si hermes config check signale des options manquantes après une mise à jour, exécutez hermes config migrate puis vérifiez à nouveau.
2

Exécutez un vrai test de chat

La commande suivante envoie une requête réelle via CometAPI :
Une configuration réussie renvoie CONNECTED et aucune erreur d’authentification ou de point de terminaison. Lorsque la configuration Claude Messages est active, cela confirme que Hermes peut utiliser le transport anthropic_messages via CometAPI.

​
Configuration facultative

Si vous remplacez une ancienne installation de Hermes, utilisez d’abord le désinstalleur intégré :
Dans le désinstalleur, choisissez Full uninstall pour supprimer la CLI, l’entrée PATH et les données ~/.hermes/. Relancez ensuite l’étape d’installation et poursuivez avec la même configuration CometAPI.
Si vous préférez le flux interactif pour la route compatible OpenAI, exécutez hermes model et choisissez Custom endpoint.Saisissez ensuite les valeurs suivantes :
  • URL de base : https://api.cometapi.com/v1
  • Clé API : votre clé API CometAPI
  • Modèle : un model ID de modèle de texte CometAPI actuel
Ce flux écrit les paramètres du fournisseur compatible OpenAI dans config.yaml. Pour Claude Messages, modifiez config.yaml directement afin que le fournisseur nommé conserve transport: anthropic_messages.