Hermes Agent

​

Présentation

​

Prérequis

​

1. Configuration système et exigences relatives aux modèles

• Environnement de terminal : Hermes Agent s’exécute en ligne de commande sous macOS, Linux et Windows (natif ou WSL2).
• Exigences de contexte du modèle : Hermes Agent recommande d’utiliser un modèle disposant d’une longueur de contexte d’au moins 64K (64 000) tokens. En effet, le prompt système et les définitions d’outils occupent déjà une part importante du contexte ; une fenêtre trop petite risque d’être saturée et de ne laisser aucune place à la conversation, ce qui provoque un refus au démarrage. En cas d’erreur liée au contexte, il suffit de passer à un modèle disposant d’un contexte plus grand (les séries Claude / Gemini d’EvoLink répondent toutes à cette exigence).

​

2. Obtenir une clé API EvoLink

• Connectez-vous au tableau de bord EvoLink
• Trouvez les clés API dans le tableau de bord, cliquez sur le bouton « Créer une nouvelle clé », puis copiez la clé générée
• La clé API commence généralement par sk-, conservez-la précieusement

​

Étape 1 : Installer Hermes Agent

• macOS / Linux
• Windows

Exécutez le script d’installation en une commande dans le terminal :

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Une fois l’installation terminée, rechargez la configuration du terminal pour activer la commande :

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

Premier lancement : choisir le mode d’installation (Quick ou Full)Le premier lancement de hermes ouvre l’assistant d’installation interactif, qui demande d’abord de quelle manière vous souhaitez configurer Hermes :

• Quick Setup (Nous Portal) — connexion via le login OAuth gratuit de Nous, sans clé API, configuration automatique des modèles et des outils, la prise en main la plus rapide. Mais ce mode utilise par défaut les modèles du Nous Portal, pas EvoLink ; pour intégrer EvoLink, vous devrez exécuter hermes model séparément après l’installation (voir Étape 2).
• Full setup — vous configurez vous-même chaque fournisseur, outil et option (avec vos propres clés). Cette option est recommandée pour les utilisateurs qui souhaitent intégrer directement EvoLink : vous renseignez l’adresse de l’interface et la clé EvoLink en une seule fois pendant l’installation.

Voici les étapes clés pour choisir Full setup et intégrer EvoLink :

1

Choisir Full setup

Utilisez les flèches du clavier pour sélectionner Full setup — configure every provider, tool & option yourself (bring your own keys), puis appuyez sur Entrée pour confirmer.

2

Choisir le fournisseur : Custom endpoint

Dans la liste des fournisseurs, descendez et sélectionnez custom endpoint (enter URL manually). Comme EvoLink fournit une interface compatible OpenAI, on passe ici par un « endpoint personnalisé » pour l’intégration.

3

Renseigner l'adresse de l'interface EvoLink et la clé API

L’assistant vous invite à saisir successivement les informations de l’endpoint :

• API base URL : saisissez https://direct.evolink.ai/v1
• API key : saisissez votre clé API EvoLink (commençant par sk-)

Après la saisie, l’assistant vérifie automatiquement l’endpoint. Si vous voyez un message du type Verified endpoint via https://direct.evolink.ai/v1/models (154 model(s) visible), cela signifie que l’interface est joignable et que la clé est valide. Continuez ensuite en suivant les invites pour choisir le modèle et les outils par défaut.

Résultat attendu : une fois l’assistant terminé, la page Installation Complete (installation terminée) s’affiche et liste l’emplacement des fichiers de configuration ainsi que les commandes courantes.

Les environnements WSL2 et Android (Termux) utilisent également le script install.sh ci-dessus pour l’installation.

Exécutez la commande d’installation en une ligne dans PowerShell :

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Résultat attendu : vous verrez les informations de téléchargement et d’installation, puis un message confirmant la réussite de l’installation.En cas d’erreur : si un message signale une restriction liée à la stratégie d’exécution, ouvrez PowerShell en tant qu’administrateur, ou exécutez d’abord Set-ExecutionPolicy -Scope CurrentUser RemoteSigned puis réessayez.Après l’installation, le premier lancement de hermes ouvre lui aussi l’assistant d’installation Quick / Full ; les étapes d’intégration d’EvoLink sont identiques à celles de l’onglet macOS / Linux (il est recommandé de choisir Full setup et de renseigner dans l’assistant l’adresse de l’interface EvoLink et la clé).

Les utilisateurs macOS et Windows peuvent aussi télécharger le programme d’installation de bureau Hermes Desktop depuis le site officiel de Hermes et l’installer d’un double-clic.

​

Vérifier l’installation

hermes doctor

​

Étape 2 : Configurer l’API EvoLink (utilisateurs Quick ou reconfiguration)

• ~/.hermes/.env — stocke les secrets comme la clé API
• ~/.hermes/config.yaml — stocke la configuration non sensible (modèle, fournisseur, etc.)

• Assistant de configuration (recommandé)
• Configuration en ligne de commande
• Modifier manuellement les fichiers de configuration

Hermes propose un assistant de configuration interactif, adapté aux nouveaux utilisateurs (en particulier ceux ayant choisi Quick Setup). Dans le terminal, exécutez :

hermes model

1

Choisir le fournisseur : Custom endpoint

Dans la liste des fournisseurs, descendez et sélectionnez custom endpoint (enter URL manually), afin d’intégrer l’endpoint compatible OpenAI d’EvoLink.

2

Renseigner l'adresse de l'interface, la clé et choisir le mode de compatibilité

Saisissez successivement les informations de l’endpoint, puis choisissez le mode de compatibilité API une fois la vérification réussie :

• API base URL : saisissez https://direct.evolink.ai/v1
• API key : saisissez votre clé API EvoLink (commençant par sk-)
• API compatibility mode : choisissez Chat Completions (standard OpenAI-compatible endpoints)

Un message du type Verified endpoint via https://direct.evolink.ai/v1/models (163 model(s) visible) indique que l’interface est joignable et que la clé est valide.

3

Choisir le modèle par défaut

Enfin, saisissez le nom du modèle à utiliser comme modèle par défaut (par ex. claude-sonnet-4-6, claude-opus-4-8, etc.), puis appuyez sur Entrée pour confirmer.

L’assistant écrit automatiquement la clé API dans ~/.hermes/.env, et la configuration du modèle et de l’endpoint dans ~/.hermes/config.yaml, sans qu’il soit nécessaire de modifier les fichiers manuellement.

hermes model est l’étape la plus importante pour les utilisateurs Quick souhaitant intégrer EvoLink. Une fois terminée, vous pouvez passer directement à l’étape suivante pour commencer à utiliser l’outil.

Si vous disposez déjà de votre clé API EvoLink, vous pouvez écrire la configuration directement en ligne de commande.

​

1. Définir la clé API (écriture dans .env)

hermes config set OPENAI_API_KEY votre_clé_API_EvoLink

​

2. Définir l’adresse de l’interface et le modèle (écriture dans config.yaml)

hermes config set OPENAI_BASE_URL https://direct.evolink.ai/v1
hermes config set model claude-sonnet-4-6

hermes config set écrit automatiquement les secrets de type clé API dans .env, et le reste de la configuration dans config.yaml ; vous n’avez pas à vous soucier du fichier de destination.

Une fois terminé, vous pouvez exécuter hermes config pour vérifier que la configuration actuelle est correcte.

Utilisateurs avancés : la méthode ci-dessous consiste à modifier directement les fichiers de configuration. Pour la plupart des utilisateurs, il est recommandé d’utiliser l’« Assistant de configuration » ci-dessus.

​

1. Modifier ~/.hermes/.env

Ouvrez (ou créez) ~/.hermes/.env et renseignez la clé API et l’adresse de l’interface :

OPENAI_API_KEY=votre_clé_API_EvoLink
OPENAI_BASE_URL=https://direct.evolink.ai/v1

​

2. Modifier ~/.hermes/config.yaml

Ouvrez (ou créez) ~/.hermes/config.yaml et configurez le modèle principal sur l’endpoint personnalisé :

model:
  provider: custom
  default: claude-sonnet-4-6
  base_url: https://direct.evolink.ai/v1
  api_mode: chat_completions

⚠️ Important :

• Remplacez votre_clé_API_EvoLink par votre clé API réelle
• base_url doit être https://direct.evolink.ai/v1 (l’adresse de l’interface compatible OpenAI d’EvoLink)
• N’utilisez pas de ponctuation saisie avec une méthode d’entrée chinoise (comme le deux-points chinois ：)

Explication des paramètres :

• provider: custom : utilise un endpoint personnalisé compatible OpenAI (c’est-à-dire EvoLink)
• base_url : adresse de l’interface de l’API EvoLink
• api_mode: chat_completions : utilise l’interface standard Chat Completions
• default : nom du modèle utilisé par défaut

​

Étape 3 : Commencer à utiliser et vérifier

​

1. Lancer Hermes Agent

hermes          # mode ligne de commande classique

hermes --tui    # interface de terminal moderne

​

2. Vérifier la configuration

Qui es-tu

• Vous voyez la réponse de l’IA (quelques lignes de texte)
• Aucune erreur du type 401, 403, API key invalide, ou context length (longueur de contexte) n’apparaît

• 401 Unauthorized : la clé API n’est pas définie ou est invalide → vérifiez OPENAI_API_KEY dans ~/.hermes/.env
• 403 Forbidden : permissions insuffisantes ou clé expirée → vérifiez la clé API
• Erreur liée à context length : le modèle choisi a un contexte inférieur à 64K → passez à un modèle répondant à l’exigence
• No API key / provider not found : aucune clé trouvée → exécutez à nouveau hermes config set OPENAI_API_KEY ...

​

3. Reprendre une session précédente

hermes --continue    # reprendre la dernière session
hermes -c            # forme abrégée

​

Configuration avancée (facultatif)

​

Modèles de secours (Fallback)

fallback_providers:
  - provider: custom
    model: claude-sonnet-4-6
    base_url: https://direct.evolink.ai/v1
  - provider: custom
    model: claude-haiku-4-5-20251001
    base_url: https://direct.evolink.ai/v1

​

Modèles auxiliaires (Auxiliary)

auxiliary:
  title_generation:
    provider: custom
    model: claude-haiku-4-5-20251001
    base_url: https://direct.evolink.ai/v1
    api_key: votre_clé_API_EvoLink
  compression:
    provider: custom
    model: claude-haiku-4-5-20251001
    base_url: https://direct.evolink.ai/v1
    api_key: votre_clé_API_EvoLink

​

FAQ

​

1. Qu’est-ce que Hermes Agent ? À quoi sert-il principalement ?

​

2. Hermes Agent et les modèles Hermes 3 / Hermes 4, c’est la même chose ?

​

3. Pourquoi utiliser provider: custom pour intégrer EvoLink ?

​

4. Que faire si un message signale une longueur de contexte (context length) insuffisante au démarrage ?

​

5. Quelles sont généralement les causes des erreurs 401 / 403 ?

• Erreur 401 : OPENAI_API_KEY non défini ou clé API invalide
• Erreur 403 : permissions insuffisantes ou clé API expirée
• Vérifiez la clé dans ~/.hermes/.env, ainsi que la valeur de base_url (https://direct.evolink.ai/v1)

​

6. Pourquoi mes modifications de configuration ne prennent-elles pas effet ?

• Vérifiez que la configuration est écrite dans le bon fichier : la clé API dans ~/.hermes/.env, le modèle/endpoint dans ~/.hermes/config.yaml
• Exécutez hermes config pour voir la configuration réellement active
• Vérifiez que l’indentation et la syntaxe de config.yaml sont correctes (YAML est sensible à l’indentation)
• Redémarrez Hermes

​

7. Comment changer de modèle ?

• Interactif : exécutez hermes model pour resélectionner
• Ligne de commande : exécutez hermes config set model nom_du_modèle
• Modifiez directement la valeur de model.default dans ~/.hermes/config.yaml

​

8. Quels modèles courants EvoLink prend-il en charge ?

​

9. Comment consulter ma consommation ?

​

10. Où se trouvent respectivement le fichier de configuration et le fichier de secrets ?

• Secrets (clé API) : ~/.hermes/.env
• Configuration des modèles et des fournisseurs : ~/.hermes/config.yaml
• Vous pouvez exécuter hermes config edit pour ouvrir directement le fichier de configuration et le modifier.

​

11. Comment ouvrir un terminal en ligne de commande ?

​

Remarques