Wie kann ich Hermes Agent mit der weber.cloud AI benutzen?

Hermes Agent ist ein Open-Source-KI-Agent von Nous Research, mit dem Sie Programmier- und Automatisierungsaufgaben direkt im Terminal oder in der Desktop-App an ein Sprachmodell delegieren können. Hermes ist nicht fest an einen einzelnen Anbieter gebunden: Über einen frei konfigurierbaren Custom-Provider (OpenAI-kompatible Schnittstelle) lässt es sich mit einem beliebigen API-Endpunkt betreiben.

Damit können Sie Hermes Agent vollständig mit den KI-Modellen der weber.cloud betreiben. Ihre Anfragen und Quellcode-Auszüge verlassen dabei nicht unsere Infrastruktur in Deutschland – ein wesentlicher Vorteil gegenüber der Nutzung ausländischer Anbieter, insbesondere bei sensiblen Projekten und im Hinblick auf DSGVO-Konformität und Datensouveränität.

Voraussetzungen

• Ein aktiver Zugang zur weber.cloud AI: Wie erhalte ich einen Zugang zur weber.cloud Managed AI?
• Ein gültiger API-Key (Format: sk-...), den Sie im weber.cloud AI Portal erhalten haben
• Eine lokale Installation von Hermes Agent (Installationsanleitung von Nous Research)

Schritt 1: Hermes Agent installieren

Installieren Sie Hermes Agent gemäß der offiziellen Anleitung von Nous Research:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Danach starten Sie Hermes einmalig mit hermes, damit die Konfigurationsdatei angelegt wird. Die Konfiguration liegt anschließend unter ~/.hermes/config.yaml (unter Windows: C:\Users\<Benutzername>\.hermes\config.yaml).

Schritt 2: Die weber.cloud AI als Custom-Provider einrichten

Öffnen Sie die Konfigurationsdatei mit Ihrem bevorzugten Editor:

hermes config edit

Tragen Sie unter providers einen Custom-Provider ein, der auf die weber.cloud API zeigt, und setzen Sie ihn als Standardmodell:

model:
  default: deepseek/deepseek-v4-flash
  provider: custom:custom

providers:
  custom:
    name: weber.cloud AI
    base_url: https://api.webercloud.ai/v1
    api_key: ***
    model: deepseek/deepseek-v4-flash
    discover_models: true
    models:
      qwen/qwen3.5-122b-a10b: {}
      deepseek/deepseek-v4-flash: {}
    default_model: deepseek/deepseek-v4-flash

Ersetzen Sie *** durch Ihren persönlichen API-Key (Format: sk-...). Alternativ können Sie den API-Key auch über eine Umgebungsvariable hinterlegen, anstatt ihn direkt in die Konfigurationsdatei einzutragen.

Hinweis: Die weber.cloud API ist OpenAI-kompatibel, daher lautet die Basis-URL https://api.webercloud.ai/v1.

Schritt 3: Verbindung testen

Prüfen Sie, ob die Konfiguration korrekt ist und Hermes die weber.cloud AI erreicht:

hermes doctor

Anschließend starten Sie Hermes und stellen eine erste Anfrage. Wenn Sie die weber.cloud AI verwenden möchten, ohne den Standard-Provider zu ändern, können Sie das Modell auch pro Aufruf auswählen:

hermes chat -m deepseek/deepseek-v4-flash

Modellauswahl

Über den Parameter -m bzw. --model wählen Sie das gewünschte Modell aus. Wir stellen eine Reihe von Modellen bereit, die Sie im weber.cloud Kundenportal einsehen und über discover_models: true automatisch in Hermes auflisten lassen können. Für die Arbeit mit Hermes Agent empfehlen sich Modelle mit ausgeprägten Coding- und Tool-Use-Fähigkeiten sowie einem großen Kontextfenster.

Beispiele verfügbarer und empfohlener Modelle:

Hinweis zur Modellauswahl: Nicht alle Modelle unterstützen die erweiterten Funktionen von Hermes Agent (Tool-Use, strukturierte Ausgaben) in gleichem Maße. Sollten einzelne Werkzeugaufrufe fehlschlagen, testen Sie ein alternatives Modell. Unsere aktuell verfügbaren Modelle können Sie unter weber.cloud Managed AI finden. Sollten wir ein Modell nicht anbieten, dass Sie gerne hätten - kontaktieren Sie uns gerne!

Hinweise

• Abgrenzung: Die Konfiguration richtet ausschließlich die API-Anfragen von Hermes Agent auf die weber.cloud AI um.
• Tokens einsehen: Ihren Token-Verbrauch, die Anzahl der Requests sowie die Modellaktivität können Sie jederzeit im weber.cloud Kundenportal einsehen.
• Weitere Tools: Neben Hermes Agent können Sie auch andere Open-Source-Agenten wie Claude Code oder Codex über die OpenAI-kompatible weber.cloud API betreiben. Passende Anleitungen finden Sie in unserer Wissensdatenbank.