> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Utiliser Hermes Agent avec CometAPI

> Utilisez ce guide pour connecter Hermes Agent à CometAPI via les paramètres de chat compatibles OpenAI ou Anthropic Messages.

Utilisez [CometAPI](https://www.cometapi.com) comme fournisseur de modèle pour [Hermes Agent](https://hermes-agent.nousresearch.com/docs/). 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

<Steps>
  <Step title="Obtenez votre clé API CometAPI">
    Connectez-vous à la [console CometAPI](https://www.cometapi.com/console/token). Cliquez sur **Add API Key** et copiez votre clé API CometAPI.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/overview/810968_364191.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=aef81a83f29f8eb16655ed4060425f50" alt="Tableau de bord CometAPI montrant le bouton Add API Key" width="3824" height="1892" data-path="images/overview/810968_364191.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/HhtmQffktazbxUvS/images/overview/810968_364193.png?fit=max&auto=format&n=HhtmQffktazbxUvS&q=85&s=d893f659267150d0faf45f99eb5dffc1" alt="Détails de la clé API CometAPI avec l’URL de base affichée" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>

  <Step title="Installez Hermes Agent">
    La commande suivante exécute l’installateur officiel :

    ```bash theme={null}
    curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
    ```

    Si le shell actuel ne reconnaît pas encore la commande `hermes`, rechargez la configuration du shell :

    ```bash theme={null}
    source ~/.zshrc
    # or
    source ~/.bashrc
    ```

    <Note>
      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.
    </Note>
  </Step>
</Steps>

## Configuration

Choisissez la route CometAPI qui correspond à la famille de modèles :

| Famille de modèles                  | Configuration Hermes                                                                               | Route CometAPI              |
| ----------------------------------- | -------------------------------------------------------------------------------------------------- | --------------------------- |
| Modèles de texte compatibles OpenAI | `model.provider: custom` avec `base_url: https://api.cometapi.com/v1`                              | `/v1/chat/completions`      |
| Modèles Claude                      | Fournisseur nommé avec `transport: anthropic_messages`                                             | `/v1/messages`              |
| Modèles Gemini dans Hermes          | Utilisez la configuration compatible OpenAI                                                        | `/v1/chat/completions`      |
| Appels directs à l’API Gemini       | Utilisez l’[API Gemini `generateContent`](/api/text/gemini-generating-content) en dehors de Hermes | `/v1beta` `generateContent` |

<Warning>
  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`](/api/text/gemini-generating-content).
</Warning>

<Steps>
  <Step title="Stockez votre clé CometAPI">
    Ouvrez `~/.hermes/.env` et ajoutez les valeurs suivantes :

    ```dotenv theme={null}
    COMETAPI_KEY=<COMETAPI_KEY>
    OPENAI_API_KEY=<COMETAPI_KEY>
    ```

    `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.
  </Step>

  <Step title="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 :

    ```yaml theme={null}
    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 de texte actuel depuis la [page des modèles CometAPI](https://www.cometapi.com/models/).

    <Note>
      Conservez la clé API dans `~/.hermes/.env`. N’intégrez pas les secrets en dur dans `config.yaml`.
    </Note>

    <Note>
      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.
    </Note>
  </Step>

  <Step title="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é :

    ```yaml theme={null}
    model:
      provider: cometapi-claude
      default: your-claude-model-id

    providers:
      cometapi-claude:
        base_url: https://api.cometapi.com
        key_env: COMETAPI_KEY
        transport: anthropic_messages
        default_model: your-claude-model-id
    ```

    Remplacez `your-claude-model-id` par un model ID Claude actuel depuis la [page des modèles CometAPI](https://www.cometapi.com/models/).

    <Note>
      Conservez `base_url` à `https://api.cometapi.com` pour cette route. Hermes utilise le transport Anthropic Messages depuis le fournisseur nommé.
    </Note>
  </Step>
</Steps>

## Vérification

<Steps>
  <Step title="Vérifiez la configuration">
    La commande suivante confirme que Hermes peut lire la configuration et la clé API :

    ```bash theme={null}
    hermes config check
    ```

    Si `hermes config check` signale des options manquantes après une mise à jour, exécutez `hermes config migrate` puis vérifiez à nouveau.
  </Step>

  <Step title="Exécutez un vrai test de chat">
    La commande suivante envoie une requête réelle via CometAPI :

    ```bash theme={null}
    hermes chat -Q --ignore-rules --max-turns 1 -q "Reply with CONNECTED only."
    ```

    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.
  </Step>
</Steps>

## Configuration facultative

<AccordionGroup>
  <Accordion title="Réinstallation propre (facultatif)">
    Si vous remplacez une ancienne installation de Hermes, utilisez d’abord le désinstalleur intégré :

    ```bash theme={null}
    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.
  </Accordion>

  <Accordion title="Utiliser le modèle hermes à la place (facultatif)">
    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`.
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#howto",
        "name": "Utiliser Hermes Agent avec CometAPI",
        "description": "Utilisez ce guide pour connecter Hermes Agent à CometAPI via un chat compatible OpenAI ou les paramètres Anthropic Messages.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-1",
            "position": 1,
            "name": "Obtenez votre clé API CometAPI",
            "text": "Créez ou ouvrez votre compte CometAPI, puis copiez une clé API active depuis le tableau de bord."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-2",
            "position": 2,
            "name": "Installer Hermes Agent",
            "text": "Effectuez l’étape Install Hermes Agent dans le guide Use Hermes Agent with CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-3",
            "position": 3,
            "name": "Enregistrez votre clé CometAPI",
            "text": "Effectuez l’étape Store your CometAPI key dans le guide Use Hermes Agent with CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-4",
            "position": 4,
            "name": "Configurer la route compatible OpenAI",
            "text": "Effectuez l’étape Configure the OpenAI-compatible route dans le guide Use Hermes Agent with CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-5",
            "position": 5,
            "name": "Configurer la route Claude Messages",
            "text": "Effectuez l’étape Configure the Claude Messages route dans le guide Use Hermes Agent with CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-6",
            "position": 6,
            "name": "Vérifier la configuration",
            "text": "Effectuez l’étape Check the configuration dans le guide Use Hermes Agent with CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-7",
            "position": 7,
            "name": "Exécuter un test de chat réel",
            "text": "Effectuez l’étape Run a real chat test dans le guide Use Hermes Agent with CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Documentation CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Intégrations",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Utiliser Hermes Agent avec CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/hermes-agent"
          }
        ]
      }
    ]
    }
    `}
</script>