Passer au contenu principal
Utilisez CometAPI comme fournisseur de modèle pour Hermes Agent via la prise en charge par Hermes des endpoints OpenAI-compatible personnalisés.

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é <COMETAPI_KEY>.
Tableau de bord CometAPI affichant 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 :
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
Si le shell actuel ne voit pas encore la commande hermes, rechargez la configuration du shell :
source ~/.zshrc
# or
source ~/.bashrc
Hermes stocke sa configuration dans ~/.hermes/, lie la commande hermes dans ~/.local/bin et peut ajouter ~/.local/bin au PATH de votre shell.

Configuration

1

Stockez votre clé CometAPI

Ouvrez ~/.hermes/.env et ajoutez la ligne suivante :
OPENAI_API_KEY=<COMETAPI_KEY>
Hermes utilise OPENAI_API_KEY comme solution d’authentification de repli pour les endpoints OpenAI-compatible personnalisés.
2

Configurez l’endpoint CometAPI

Ouvrez ~/.hermes/config.yaml et assurez-vous que la section model ressemble à ceci :
model:
  provider: custom
  default: your-model-id
  base_url: https://api.cometapi.com/v1
Remplacez your-model-id par un model ID de modèle texte actuel depuis la page des modèles CometAPI.
Conservez la clé API dans ~/.hermes/.env. N’encodez pas de secrets en dur dans config.yaml.
Cette configuration définit le modèle de chat principal. Hermes peut utiliser des modèles auxiliaires distincts pour des tâches comme la vision ou l’extraction web.

Vérification

1

Vérifiez la configuration

Les commandes suivantes confirment que Hermes peut lire la configuration et la clé API :
hermes config check
hermes doctor
hermes status
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 vraie requête via CometAPI :
hermes chat -q "Reply with the single word CONNECTED."
Une configuration réussie renvoie CONNECTED sans erreur d’authentification ni d’endpoint.

Configuration facultative

Si vous remplacez une ancienne installation de Hermes, utilisez d’abord le désinstalleur intégré :
hermes uninstall
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, exécutez hermes model et choisissez Custom endpoint.Saisissez ensuite les valeurs suivantes :
  • Base URL: https://api.cometapi.com/v1
  • API key: votre clé API CometAPI
  • Model: un model ID de modèle texte CometAPI actuel
Ce flux écrit les mêmes paramètres de provider dans config.yaml.