Hermes Agent aufsetzen

Hermes ist ein self-hosted AI Agent von Nous Research (GitHub-Repo). Mit lowcloud Platform deployst du deine eigene Hermes-Instanz mit einem Klick in dein Projekt. Keine Server-Einrichtung, kein Container-Setup, kein manuelles Volume-Management.

Hermes bekommt standardmäßig keine öffentliche URL. Deine Instanz ist privat, bis du das selbst änderst. Die Einrichtung läuft komplett im Browser über den Shell-Tab des Services.

Voraussetzungen

• Ein Projekt auf lowcloud Platform
• Ein API Key deines Model Providers (z. B. Anthropic)

Hermes deployen

Klicke in deinem Projekt auf + Create Service → Hermes Agent.

1. Benenne deinen Service (z. B. hermes). Andere Services in diesem Projekt erreichen die Instanz später unter diesem Namen.
2. Wähle einen Container Size Tier. Hermes ist ein AI Agent und braucht entsprechend Ressourcen. Das Minimum ist Medium, wir empfehlen Large.
3. Klicke auf Deploy Hermes Agent.

Ein Block-Storage-Volume mit 10 GiB wird automatisch bereitgestellt und unter /opt/data gemountet. Dort speichert Hermes seine Konfiguration und seinen State, beides übersteht Neustarts und Redeploys.

Onboarding über die Shell

Nach dem Deploy startet der Service ohne Konfiguration und bleibt stabil im Status Running. Bevor du Hermes nutzen kannst, läufst du einmalig durch das Onboarding:

1. Öffne deinen Hermes-Service und wechsle in den Shell-Tab.
2. Führe das Setup aus:

hermes setup

3. Folge dem interaktiven Assistenten. Dort verbindest du deinen Model Provider (z. B. mit einem API Key) und konfigurierst den Agent. Verbinde dabei am besten direkt einen Messaging-Channel, dann erreichst du deinen Agent danach bequem aus deiner Chat-App.

Die Konfiguration landet auf dem persistenten Volume unter /opt/data, du musst das Setup also nur einmal durchlaufen.

Auch ohne Messaging-Channel kannst du jederzeit über die Shell mit Hermes interagieren:

hermes

Optional: API freischalten

Hermes bringt einen OpenAI-kompatiblen API Server mit. Standardmäßig ist er aus und der Service bindet keinen Port. Zum Aktivieren setzt du im Environment-Tab drei Variablen:

Neue Werte greifen nach dem nächsten Redeploy. Danach lauscht der API Server auf Port 8642.

Andere Services im selben Projekt erreichen die API über das interne Netzwerk unter dem Service-Namen:

http://<service-name>:8642/v1

Authentifiziert wird mit dem Key als Bearer Token:

curl http://<service-name>:8642/v1/models \
  -H "Authorization: Bearer <API_SERVER_KEY>"

Zusammenfassung

• + Create Service → Hermes Agent, Name und Tier wählen, deployen.
• 10 GiB persistenter Storage unter /opt/data kommen automatisch dazu.
• Einmalig im Shell-Tab hermes setup ausführen und dabei am besten einen Messaging-Channel verbinden.
• Optional: API Server per Environment Variables aktivieren und intern über http://<service-name>:8642/v1 nutzen.

Weitere Infos zu Hermes selbst findest du in der offiziellen Hermes-Doku und im GitHub-Repo.