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
- Öffnen Sie https://ai2save.com/keys.
- Erstellen Sie einen Schlüssel und wählen Sie die Gruppe, die das Zielmodell enthält.
- Kopieren Sie den vollständigen
sk-...-Schlüssel. - 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/v1geliefert werden, Hermes wird darauf basierend/chat/completionsanfordern.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
- Beende die aktuelle Hermes-Sitzung oder Gateway vollständig.
- Starte Hermes neu.
- Erstelle eine neue Sitzung und sende eine kurze Frage.
- Gib in der Sitzung
/modelein, um sicherzustellen, dass das aktuelle Modellcustom/gpt-5.5odergpt-5.5ist.
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_KEYexistiert nicht oder der Wert ist unvollständig. Führen Siehermes config get model.key_envaus, um die Referenz zu überprüfen. - 404 / model not found:
model.defaultist keine über das Dashboard verfügbare reale Modell-ID. - Verbindungsfehler:
base_urlsolltehttps://ai2save.com/v1sein; nichthttps://ai2save.comschreiben. - Konfiguration nicht wirksam: Alte
OPENAI_BASE_URLwirkt nur aufopenai-apiProvider und wird nicht automatisch aufcustomangewendet; prüfen Sieconfig.yamlinmodel.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.