# Guide de configuration Hermes Agent

> Pointez le fournisseur personnalisé de Hermes Agent vers LLMoxy via ~/.hermes/config.yaml et .env pour accéder aux modèles complets des séries GPT / Claude / Gemini.

Site web : [https://hermes-agent.nousresearch.com (cliquez pour accéder !)](https://hermes-agent.nousresearch.com)

> **📌 À propos de Hermes Agent**
> Hermes Agent est un agent IA terminal open source lancé par Nous Research, prenant en charge trois points d'entrée CLI / TUI / API Server, et pouvant se connecter à n'importe quel point de terminaison compatible OpenAI.

## Adresse du code source

- GitHub : [NousResearch/hermes-agent](https://github.com/NousResearch/hermes-agent)
- Documentation officielle : [hermes-agent.nousresearch.com/docs](https://hermes-agent.nousresearch.com/docs)

## 1. Installer Hermes Agent

### Méthode 1 : Installation pip (recommandée)

```bash
pip install hermes-agent
hermes postinstall    # Optionnel : installation automatique de Node.js / navigateur / ripgrep / ffmpeg
```

### Méthode 2 : Installation par script (suivre la branche main)

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

Après l'installation, rechargez Shell :

```bash
source ~/.zshrc    # ou source ~/.bashrc
```

## 2. Processus de configuration principal

Les paramètres de Hermes Agent sont concentrés dans le répertoire `~/.hermes/` :

| Fichier | Utilisation |
| --- | --- |
| `~/.hermes/config.yaml` | Toute la configuration non sensible : modèle, fournisseur, terminal, compression, etc. |
| `~/.hermes/.env` | Clé API et autres informations d'identification sensibles |

### 1. Configurer config.yaml (fournisseur personnalisé)

Ouvrez ou créez `~/.hermes/config.yaml`, écrivez le bloc `model` comme fournisseur `custom`, et pointez `base_url` vers LLMoxy :

```yaml
model:
  provider: custom
  base_url: "https://llmoxy.com/v1"
  model: "grok-4.7"
```

Vous pouvez également utiliser l'écriture en un clic CLI (atterrit automatiquement dans `config.yaml`) :

```bash
hermes config set model.provider custom
hermes config set model.base_url https://llmoxy.com/v1
hermes config set model.model grok-4.7
```

### 2. Configurer .env (écrire la clé API)

Écrivez le jeton LLMoxy dans `~/.hermes/.env` :

```
OPENAI_API_KEY=<LLMOXY_API_KEY>xxxxxxxxxxxxxxx
```

Ou utilisez CLI (recommandé, achemine automatiquement vers `.env` sans fuiter vers YAML) :

```bash
hermes config set OPENAI_API_KEY <LLMOXY_API_KEY>xxxxxxxxxxxxxxx
```

Remplacez `<LLMOXY_API_KEY>xxxxxxxxxxxxxxx` par le vrai jeton obtenu depuis la [Console LLMoxy](https://llmoxy.com/).

> **💡 Astuce**
> Veuillez utiliser un jeton du groupe **auto**. Hermes Agent appelle LLMoxy via le protocole OpenAI Chat Completions ; `base_url` doit inclure `/v1`.

## 3. Configuration rapide interactive (optionnel)

Si vous ne voulez pas éditer manuellement le YAML, exécutez `hermes model` pour entrer l'assistant interactif :

```bash
hermes model
```

Sélectionnez dans l'ordre :

1. Dans les options du fournisseur, choisissez **Custom Endpoint**
2. Base URL entrez `https://llmoxy.com/v1`
3. Clé API collez le jeton LLMoxy
4. Modèle entrez `grok-4.7`

## 4. Lancer Hermes

```bash
hermes          # CLI classique
hermes --tui    # Interface TUI moderne (recommandée)
```

Après le lancement, la bannière de bienvenue affichera le modèle et le fournisseur actuellement actifs ; vous pouvez entrer un prompt de test pour vérifier la connectivité.

## Exemple de configuration complet

```yaml
# ~/.hermes/config.yaml
model:
  provider: custom
  base_url: "https://llmoxy.com/v1"
  model: "grok-4.7"
```

```
# ~/.hermes/.env
OPENAI_API_KEY=<LLMOXY_API_KEY>xxxxxxxxxxxxxxx
```

> **💡 Astuce sur les règles de nommage des modèles**
> `grok-4.7` est l'ID de modèle standard sur LLMoxy, consultable dans la console « Liste des modèles ». Autres modèles courants :
> - **Série GPT** : `gpt-6.1-sol`
> - **Série Claude** : `claude-opus-5-5`, `claude-fable-5-2`

## Priorité de configuration

Hermes Agent lit la configuration selon cette priorité (de haut en bas) :

1. Paramètres de ligne de commande
2. `~/.hermes/config.yaml`
3. `~/.hermes/.env`
4. Valeurs par défaut intégrées

Après modification de la configuration, pas besoin de redémarrer Hermes ; la prochaine nouvelle session chargera automatiquement le dernier `config.yaml`.

Ceci est la version markdown de https://fr.llmoxy.com/docs/code-tutorials/hermes-agent.
