ai2saveai2save

Tutoriel de configuration Hermes Agent

Le modèle Hermes Agent, le fournisseur et le endpoint personnalisé sont tous enregistrés dans ~/.hermes/config.yaml ; les informations sensibles comme API Key sont stockées dans ~/.hermes/.env. ai2save utilise l'interface OpenAI Compatible, Base URL est https://ai2save.com/v1.

1. Créer API Key

  1. Ouvrez https://ai2save.com/keys.
  2. Créez une clé et sélectionnez le groupe contenant le modèle cible.
  3. Copiez la clé sk-... complète.
  4. Notez l'ID réel du modèle affiché sur la console, par exemple gpt-5.5.

2. Il est recommandé d'utiliser l'assistant intégré

Exécutez dans le terminal :

hermes model

Choisissez selon les instructions :

Custom endpoint (self-hosted / vLLM / etc.)

Entrez dans l'ordre :

API base URL: https://ai2save.com/v1
API key: sk-votre-clé-api
Model name: gpt-5.5

Le guide écrira ces valeurs dans ~/.hermes/config.yaml. Ne pas écrire Base URL dans .env ; selon le protocole officiel de Hermes, la configuration du point de terminaison du modèle provient de config.yaml.

3. Édition manuelle du fichier de configuration

Éditez ~/.hermes/config.yaml :

model:
  provider: custom
  default: gpt-5.5
  base_url: https://ai2save.com/v1
  key_env: AI2SAVE_API_KEY

Explication des champs :

  • provider: custom : Utiliser n'importe quel endpoint OpenAI Compatible.
  • default : ID du modèle par défaut, doit correspondre exactement à l'ID du modèle ouvert dans la console.
  • base_url : Doit inclure /v1, Hermes fera une requête /chat/completions sur cette base.
  • key_env : Nom de la variable d'environnement pointant vers la clé enregistrée.

Modifier ~/.hermes/.env :

AI2SAVE_API_KEY=sk-votre-clé-api

.env stocke des informations sensibles, config.yaml stocke la configuration du modèle non sensible. Ne soumettez pas .env à Git.

4. Écrire en utilisant la commande de configuration

Vous pouvez également utiliser la commande intégrée de Hermes pour éviter les erreurs d'indentation YAML :

hermes config set model.provider custom
hermes config set model.default gpt-5.5
hermes config set model.base_url https://ai2save.com/v1
hermes config set model.key_env AI2SAVE_API_KEY
hermes config set AI2SAVE_API_KEY sk-votre-clé-api
hermes config check

AI2SAVE_API_KEY est le nom de la variable d'environnement en majuscules, Hermes écrira automatiquement dans ~/.hermes/.env.

5. Redémarrer et vérifier

  1. Quitter complètement la session Hermes actuelle ou Gateway.
  2. Redémarrer Hermes.
  3. Créer une nouvelle session et envoyer une courte question.
  4. Dans la session, entrer /model pour confirmer que le modèle actuel est custom/gpt-5.5 ou gpt-5.5.

Utiliser temporairement un modèle spécifié :

hermes chat --provider custom --model gpt-5.5

Pour la première validation, il est conseillé de désactiver les tâches parallèles et les outils complexes, et d'envoyer uniquement de courts textes. Une fois l'authentification et la connexion au modèle établies, activez progressivement des outils comme le terminal, le web et les fichiers.

6. Erreurs courantes

  • 401 / invalid_api_key : AI2SAVE_API_KEY n'existe pas ou sa valeur est incomplète. Exécutez hermes config get model.key_env pour vérifier la référence.
  • 404 / model not found : model.default n'est pas un ID de modèle réel ouvert dans la console.
  • Échec de connexion : base_url devrait être https://ai2save.com/v1 ; ne l'écrivez pas comme https://ai2save.com.
  • Configuration non appliquée : l'ancien OPENAI_BASE_URL n'affecte que openai-api Provider, et ne s'appliquera pas automatiquement à custom ; vérifiez config.yaml dans model.base_url.
  • Échec d'analyse de YAML : ne créez pas de blocs model: en double, fusionnez tous les champs dans un même bloc.
  • Erreur d'appel d'outil : assurez-vous d'abord que le modèle prend en charge tool calling, et établissez une ligne de base avec de courts textes avant d'activer l'ensemble des outils.