Stand: 2026-09-01

Ziel: Einen bestehenden Hermes Agenten zusätzlich zum Chat/Dashboard über eine öffentliche, OpenAI-kompatible API erreichbar machen.

<aside> ⚠️

Ein öffentlich erreichbarer Hermes API-Server ist mächtig. Der Agent kann je nach aktivierten Tools Dateien lesen/schreiben, Shell-Kommandos ausführen, Webzugriffe machen, Notion bedienen oder weitere Agenten starten. Deshalb niemals ohne Bearer Token veröffentlichen und den Token nicht ins Browser-Frontend legen.

</aside>

Was am Ende funktionieren soll

Ein externer Client soll Hermes so ansprechen können:

<https://hermes-api.example.com/v1>

und darüber zum Beispiel einen Chat-Completion-Request senden:

POST /v1/chat/completions
Authorization: Bearer <API_SERVER_KEY>
Content-Type: application/json

Hermes verhält sich dabei für den Client wie ein OpenAI-kompatibles Backend. Hinter dem Modell steckt aber nicht nur Textgenerierung, sondern ein vollwertiger Agent mit seinem konfigurierten Modell, Toolsets, Skills, Memory und Gateway-Kontext.

Zielbild

Empfohlene Trennung:

Zweck	Beispiel-URL	Interner Port
Hermes Dashboard	`https://hermes.example.com`	`4860`
Hermes API Server	`https://hermes-api.example.com/v1`	`8642`

Warum trennen?

Dashboard und API sind unterschiedliche Dienste bzw. Ports.
API-Routing auf einer eigenen Subdomain ist einfacher zu debuggen.
/v1/* landet nicht versehentlich beim Dashboard-Login.
Security-Regeln, Rate Limits und Logs lassen sich sauberer pro Host konfigurieren.