ai2saveai2save

Hermes Agent Einrichtungshandbuch

Die Modelle, Anbieter und benutzerdefinierten Endpunkte von Hermes Agent werden in ~/.hermes/config.yaml gespeichert; sensible Informationen wie API Key werden in ~/.hermes/.env gespeichert. ai2save verwendet die OpenAI Compatible-Schnittstelle, Base URL ist https://ai2save.com/v1.

1. Erstellen von API Key

  1. Öffnen Sie https://ai2save.com/keys.
  2. Erstellen Sie einen Schlüssel und wählen Sie die Gruppe, die das Zielmodell enthält.
  3. Kopieren Sie den vollständigen sk-...-Schlüssel.
  4. Notieren Sie sich die in der Konsole angezeigte echte Modell-ID, z. B. gpt-5.5.

2. Es wird empfohlen, den integrierten Assistenten zu verwenden

Führen Sie im Terminal aus:

hermes model

Wählen Sie nach den Anweisungen:

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

Geben Sie der Reihe nach ein:

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

Der Assistent schreibt diese Werte in ~/.hermes/config.yaml. Schreiben Sie Base URL nicht in .env; gemäß der offiziellen Vereinbarung von Hermes stammen die Model-Endpoint-Konfigurationen von config.yaml.

3. Manuelles Bearbeiten der Konfigurationsdatei

Bearbeiten Sie ~/.hermes/config.yaml:

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

Feldbeschreibung:

  • provider: custom: Verwenden Sie einen beliebigen OpenAI Compatible-Endpunkt.
  • default: Standardmodell-ID, muss vollständig mit der in der Konsole verfügbaren Modell-ID übereinstimmen.
  • base_url: Muss mit /v1 geliefert werden, Hermes wird darauf basierend /chat/completions anfordern.
  • key_env: Verweist auf den Namen der Umgebungsvariablen, in der der Schlüssel gespeichert ist.

Bearbeiten von ~/.hermes/.env:

AI2SAVE_API_KEY=sk-dein-api-key

.env speichert sensible Informationen, config.yaml speichert nicht-sensible Modellkonfigurationen. Reichen Sie .env nicht bei Git ein.

4. Mit dem Konfigurationsbefehl schreiben

Sie können auch die mit Hermes mitgelieferten Befehle verwenden, um YAML Einrückungsfehler zu vermeiden:

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-dein-api-key
hermes config check

AI2SAVE_API_KEY ist der Name der Großbuchstaben-Umgebungsvariablen, Hermes wird automatisch ~/.hermes/.env schreiben.

5. Neustart und Überprüfung

  1. Beende die aktuelle Hermes-Sitzung oder Gateway vollständig.
  2. Starte Hermes neu.
  3. Erstelle eine neue Sitzung und sende eine kurze Frage.
  4. Gib in der Sitzung /model ein, um sicherzustellen, dass das aktuelle Modell custom/gpt-5.5 oder gpt-5.5 ist.

Temporäre Verwendung eines bestimmten Modells:

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

Bei der ersten Überprüfung wird empfohlen, parallele Aufgaben und komplexe Werkzeuge zu deaktivieren und nur kurze Texte zu senden. Nach der Authentifizierung und der Verbindung mit dem Modell können Terminal-, Web- und Datei-Werkzeuge schrittweise aktiviert werden.

6. Häufige Fehlermeldungen

  • 401 / invalid_api_key: AI2SAVE_API_KEY existiert nicht oder der Wert ist unvollständig. Führen Sie hermes config get model.key_env aus, um die Referenz zu überprüfen.
  • 404 / model not found: model.default ist keine über das Dashboard verfügbare reale Modell-ID.
  • Verbindungsfehler: base_url sollte https://ai2save.com/v1 sein; nicht https://ai2save.com schreiben.
  • Konfiguration nicht wirksam: Alte OPENAI_BASE_URL wirkt nur auf openai-api Provider und wird nicht automatisch auf custom angewendet; prüfen Sie config.yaml in model.base_url.
  • YAML Analyse fehlgeschlagen: Keine doppelten model:-Blöcke verwenden, alle Felder in einen Block zusammenführen.
  • Fehler beim Aufrufen von Werkzeugen: Stellen Sie zunächst sicher, dass das Modell tool calling unterstützt, erstellen Sie eine Basislinie mit einer kurzen Textanfrage und aktivieren Sie dann das Werkzeugsortiment.