Guide de configuration Hermes Agent

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

📌 À 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
• Documentation officielle : hermes-agent.nousresearch.com/docs

1. Installer Hermes Agent

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

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)

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

Après l'installation, rechargez Shell :

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

2. Processus de configuration principal

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

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 :

model:
  provider: custom
  base_url: "https://llmoxy.com/v1"
  model: "gpt-5.5"

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

hermes config set model.provider custom
hermes config set model.base_url https://llmoxy.com/v1
hermes config set model.model gpt-5.5

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) :

hermes config set OPENAI_API_KEY <LLMOXY_API_KEY>xxxxxxxxxxxxxxx

Remplacez <LLMOXY_API_KEY>xxxxxxxxxxxxxxx par le vrai jeton obtenu depuis la Console LLMoxy.

💡 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 :

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 gpt-5.5 (ou autre ID de modèle pris en charge par LLMoxy, par exemple gpt-5.4)

4. Lancer Hermes

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

# ~/.hermes/config.yaml
model:
  provider: custom
  base_url: "https://llmoxy.com/v1"
  model: "gpt-5.5"

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

💡 Astuce sur les règles de nommage des modèles gpt-5.5 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-5.5, gpt-5.4, gpt-4o
• Série Claude : claude-opus-4-6, claude-sonnet-4-6, claude-haiku-4-5
• Série Gemini : gemini-2.5-pro

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.