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

# Hermes

> Connectez Hermes au point de terminaison d’API LLM compatible OpenAI de Novita.

Hermes est un outil d’agent de Nous Research. Il peut se connecter à un point de terminaison personnalisé compatible OpenAI, ce qui vous permet d’utiliser les modèles LLM de Novita dans Hermes pour des workflows d’agents locaux.

## Prérequis

Avant de commencer, préparez les valeurs suivantes :

* **Clé API** : créez ou copiez une clé API depuis [Gestion des clés](https://novita.ai/settings/key-management).
* **URL de base** : `https://api.novita.ai/openai/v1`
* **ID du modèle** : copiez l’ID du modèle que vous souhaitez utiliser depuis le Model Hub, par exemple `deepseek/deepseek-v3.1`.

<Tip>
  Hermes stocke localement les paramètres du point de terminaison et de la clé API. Ne validez aucune configuration générée contenant votre clé API.
</Tip>

## Installer Hermes

Hermes propose des options d’installation pour terminal et ordinateur de bureau. Choisissez celle qui convient à votre workflow.

### Linux / macOS / WSL2

```bash theme={"system"}
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
```

### Windows PowerShell

```bash theme={"system"}
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
```

### Bureau

Vous pouvez également télécharger Hermes Desktop depuis :

```text theme={"system"}
https://hermes-agent.nousresearch.com/desktop
```

## Configurer le point de terminaison Novita

Après l’installation, exécutez le flux de configuration de Hermes. La commande exacte peut varier selon la version de Hermes ; suivez donc les invites du terminal correspondant à votre version installée.

Pendant la configuration, utilisez les choix et valeurs suivants :

1. Sélectionnez **Custom endpoint** ou l’option qui vous permet de saisir manuellement une URL de fournisseur.
2. Définissez l’URL de base sur `https://api.novita.ai/openai/v1`.
3. Saisissez votre clé API Novita.
4. Pour le type d’API, conservez l’option de détection automatique par défaut. Si vous devez choisir manuellement, sélectionnez le mode compatible OpenAI ou Chat Completions.
5. Sélectionnez un modèle dans la liste, ou saisissez manuellement un ID de modèle Novita, par exemple `deepseek/deepseek-v3.1`.
6. Définissez le nombre maximal de tokens en fonction de la longueur de contexte du modèle. Si vous n’êtes pas sûr, conservez la valeur par défaut ou détectée automatiquement.
7. Donnez à la configuration du modèle un nom reconnaissable, par exemple `novita-deepseek-v3.1`.
8. Si vous souhaitez uniquement exécuter Hermes localement, choisissez le runtime Local par défaut.
9. Si vous n’avez pas besoin de canaux tels que Telegram, Slack ou Matrix, ignorez les canaux d’intégration.

## Recharger votre shell

Si Hermes vous demande de recharger votre shell, exécutez :

```bash theme={"system"}
source ~/.zshrc
```

## Démarrer Hermes

Démarrez Hermes depuis votre terminal :

```bash theme={"system"}
hermes
```

Envoyez un message de test, par exemple :

```text theme={"system"}
Hello, briefly describe what coding tasks you can help with.
```

Si la requête échoue, vérifiez que :

* Votre clé API est correcte.
* L’URL de base est `https://api.novita.ai/openai/v1`.
* L’ID du modèle correspond à celui affiché dans le Model Hub de Novita.
* Le type d’API sélectionné est compatible avec un point de terminaison compatible OpenAI.