📖 Guide

Anleitung: KI-Agenten einrichten

Dein erster eigener KI-Agent — in unter 5 Minuten. Keine Programmierkenntnisse nötig. Jedes Kommando auf dieser Seite wurde gegen die installierte CLI geprüft, nicht aus dem Gedächtnis geschrieben. Wo Hermes etwas anders macht als du erwartest, steht es hier.

📡 Live-Stand des Systems

Diese Werte werden beim Öffnen der Seite vom laufenden Backend geholt (/api/status, /api/tiers, /api/skills, /api/tts/status, persona_registry.json). Steht dort „—", ist das Backend nicht erreichbar — nicht: „keine Daten".

🖥

System

—

👥

Profile

—

🎭

Personas

—

🧩

Skills (Tarif —)

—

💶

Tarife

—

🔊

Sprachausgabe

—

✅ Voraussetzungen

⚠️ WICHTIG

Ein HYPDB.ONE-Account ersetzt nicht den Provider-Zugang fürs Modell. Hermes braucht beides getrennt: das HYPDB.ONE-Konto für Tarif und Portal, den Provider-Key (bzw. Nous-Login) für die Modellaufrufe.

1 Provider einrichten

Der erste Schritt ist nicht das Login — das ist genau der Irrtum, der auf vielen Anleitungen steht. hermes login ist als deprecated markiert und meldet selbst: „Use hermes auth to manage credentials, hermes model to select a provider" (Stand v0.21.5). Die drei Wege, die es wirklich gibt:

# A) Interaktiv Provider + Standardmodell wählen (empfohlen für den Einstieg): hermes model # B) Einen API-Key als gepoolte Credential hinterlegen: hermes auth add # C) Kompletter Einrichtungsassistent (Profil, Modell, Gateway, Tools): hermes setup # Zugang prüfen — zeigt alle hinterlegten Credentials: hermes auth list
💡 TIPP

hermes auth add fragt interaktiv nach Provider und Key. Für Nous-Konten gibt es hermes auth upgrade. Es gibt kein hermes login --email — dieses Kommando mit diesem Flag gibt es nicht.

2 Profil auswählen oder anlegen

Hermes arbeitet mit Profilen — jedes ist eine eigene, isolierte Installation mit eigenem Modell, eigenen Skills und eigenem Gateway. Achtung, das Kommando heisst hermes profile (Singular), nicht hermes profiles.

# Vorhandene Profile auflisten: hermes profile list # Standardprofil umschalten (wirkt sticky): hermes profile use mein-profil # Ein eigenes Profil anlegen: hermes profile create research-agent # Ein Kommando gezielt gegen ein anderes Profil ausführen: hermes -p research-agent gateway status

Profile, die auf dem Referenzsystem nach hermes profile list tatsächlich existieren:

💡 TIPP

Ein eigenes Profil ist billiger als ein neues Betriebssystem: es hat eigene Sessions, eigene Cronjobs und eigene Skills. Für einen zweiten, völlig unabhängigen Agenten legst du ein zweites Profil an — nicht eine zweite Installation.

3 Modell und Provider konfigurieren

Provider und Modell stehen in der Konfiguration unter model. — nicht unter einem nackten provider. Das ist der Grund, warum hermes config get provider bei vielen mit „Config key not set" endet, obwohl ein Provider sehr wohl gesetzt ist.

# Aktuelle Konfiguration ansehen (Pfade, Keys, Modell, Terminal): hermes config show # Richtige Schlüssel — mit model.-Praefix: hermes config get model.provider hermes config get model.default # Modell wechseln. Kürzere Form ueber die Aliase, die Hermes mitbringt: hermes config set model.default ds-flash # Oder vollstaendig, mit Provider-Praefix — so sind die Aliase gebaut: hermes config set model.default nous/deepseek/deepseek-v4-flash-0731

Modell-Aliase, die Hermes v0.21.5 mitbringt (hermes config show zeigt sie dir alle — hermes config get model.default liefert dagegen nur eine Zeile, den gesetzten Standard; die Aliase liegen im Abschnitt model: → aliases:):

# gemessen an `model: -> aliases:` in der config.yaml (Stand v0.21.5, 22 Aliase): ds-flash → nous/deepseek/deepseek-v4-flash-0731 ds-pro → nous/deepseek/deepseek-v4-pro glm-flash → nous/z-ai/glm-5.3-flash glm5 → nous/z-ai/glm-5.3 gpt-oss → nous/openai/gpt-oss-120b inkling → nous/thinkingmachines/inkling laguna → nous/poolside/laguna-s-2.1 laguna-xs→ nous/poolside/laguna-xs-2.1 ling → nous/inclusionai/ling-3.0-flash longcat → nous/meituan/longcat-2.0 mercury → nous/inception/mercury-2.5 mimo → nous/xiaomi/mimo-v2.5 mimo-pro → nous/xiaomi/mimo-v2.5-pro nemotron-ultra → nous/nvidia/nemotron-3-ultra-550b-a55b nemotron3 → nous/nvidia/nemotron-3-super-120b-a12b qwen-coder → nous/qwen/qwen3-coder-next qwen-max → nous/qwen/qwen3.5-397b-a17b qwen35 → nous/qwen/qwen3.5-35b-a3b seed-code → nous/bytedance-seed/seed-2.0-code seed2 → nous/bytedance-seed/seed-2.0-mini solar-pro4→ nous/upstage/solar-pro4 step → nous/stepfun/step-3.7-flash

Diese Liste ist eine Messung von einem Server, nicht von deiner Installation. Welche Aliasnamen bei dir gelten, zeigt hermes config show auf deinem Rechner.

💡 TIPP

Ein Modellname wie deepseek-v4-flash allein funktioniert nicht — Hermes erwartet Provider und Modell zusammen. Die Aliase (ds-flash, ds-pro, glm-flash, …) sind Kurzformen dafür. Welche Modelle dein Provider wirklich anbietet, zeigt hermes model --refresh: es fragt die Live-Modelliste des Providers ab, statt auf lokale Annahmen zu bauen.

4 Ersten Prompt senden

Dein Agent ist bereit. Am schnellsten prüfst du das im Einmal-Modus: eine Aufgabe rein, nur die fertige Antwort raus, kein Banner, keine Vorschau.

# Einmal-Aufruf, gibt nur den Antworttext aus: hermes -z "Fasse in 3 Sätzen zusammen, was Hermes kann." # Interaktives Chat-Fenster: hermes chat # In einem bestimmten Profil: hermes -p research-agent chat

Ein brauchbarer erster Prompt, der dir gleichzeitig zeigt, ob die Werkzeuge wirklich hängen:

"Recherchiere die 3 wichtigsten KI-Trends für 2026. Fasse jeden in 2 Sätzen zusammen. Nenne zu jedem Trend eine Quelle mit URL. Markiere klar, welche Angaben du nicht belegen kannst."
5 Skills, Cronjobs und Gateway

Dein Agent läuft — jetzt erweitern. Drei Achsen:

Skills

# Installierte Skills anzeigen (Tabelle mit Name/Quelle/Trust/Status): hermes skills list # Weitere Skills suchen, pruefen, installieren: hermes skills search web-research hermes skills inspect <name> hermes skills install <name> # Kompakte Ausgabe: nur die aktivierten Skills, Quellen filtern: hermes skills list --enabled-only hermes skills list --source local
⚠️ NICHT VERWENDEN

Es gibt kein hermes skills enable. Die CLI sagt wörtlich: „'enable' is not a 'hermes skills' command". Aktiviert wird ein installierter Skill ohnehin automatisch — list zeigt die Spalte „Status".

Cronjobs

# Zeitgesteuerte Aufgaben verwalten: hermes cron list hermes cron --help # Der wichtigste ist der dritte - er findet stille Fehler: hermes cron status # laeuft der Scheduler ueberhaupt? hermes cron doctor # Health-Check aller Jobs hermes cron incidents # dauerhafte Fehler anerkennen hermes cron runs # Ausfuehrungsverlauf
💡 WICHTIG

hermes cron doctor ist das Kommando, das die stillen Fehler findet. Ein aktivierter Job mit kaputtem Zeitplan tut einfach nichts, ohne Fehlermeldung — list zeigt das nicht. doctor meldet pro Job die konkrete Ursache (verpasster Lauf, Exit-Code, fehlende Datei).

📋 Was cron doctor auf dem Referenzsystem findet

Echte Ausgabe des laufenden Referenzsystems, nicht formuliert. Auf dem Bildungsserver dieses Projekts wird stattdessen der öffentliche Auftragsbestand der HYPDB.ONE-Plattform gezeigt — beides sind Cron-Aufträge, aber aus unterschiedlichen Systemen.

⚠️

Gemeldete Probleme

—

📄

Betroffene Jobs

—

⚙️

Registrierte Aufträge

—

💾

Letzte Protokolle

—

Messenger-Gateway (Telegram, Discord, WhatsApp …)

# Plattformen einrichten (interaktiv, Token wird abgefragt): hermes gateway setup # Status aller Profile / laufenden Gateways: hermes gateway list hermes gateway status
⚠️ FALSCHER WEG

Ein Bot-Token gehört nicht über hermes config set telegram.bot_token … gesetzt — dieser Schlüssel existiert in der Konfiguration nicht und die Annahme bleibt stumm wirkungslos. Richtig ist hermes gateway setup: dort wird der Token hinterlegt, validiert und in der Profil-.env gespeichert — diese Datei gehört in kein Repository.

🚀 Was kommt als Nächstes?

🤖

Profile statt Installationen

Jedes Profil ist ein eigener, isolierter Agent mit eigenem Modell, eigenen Skills und eigenem Gateway. hermes -p <name> <befehl> schaltet um, ohne dass irgendetwas neu installiert wird.

⏰

Cron-Automation

Agenten zu festen Zeiten ausführen — tägliche Reports, stündliche Checks. Der gefährlichste Cron-Fehler ist der stille: ein aktivierter Job mit kaputtem Zeitplan tut einfach nichts, ohne Meldung. hermes cron list zeigt den Zustand der Jobs, den Fehler findet erst hermes cron doctor — siehe Schritt 5.

🎭

Persona-System

Das Persona-Register wird geladen … Achtung: /api/tiers weist das Persona-System bei starter und pro mit 0 aus — enthalten ist es erst ab business (199 €).

🔗

Kanäle

Die konfigurierten Plattformen werden geladen …

🔧 Häufige Probleme & Lösungen

„Config key not set: provider"

Falscher Schlüssel. Provider und Modell liegen unter model.:

hermes config get model.provider hermes config get model.default

„Model not found"

Das Modell existiert beim Provider nicht, oder Provider und Modell sind verwechselt. Zuerst die Live-Liste des Providers holen, dann setzen:

hermes model --refresh hermes config set model.default ds-flash

„'enable' is not a 'hermes skills' command"

Veraltete Anleitung. hermes skills enable gibt es nicht — siehe Schritt 5.

„Provider authentication failed"

Zugang fehlt oder ist abgelaufen. Pool-Status prüfen und Credentials neu setzen:

hermes auth list hermes auth status <provider> hermes auth add

„Connection refused"

Prüfe zuerst, was nicht erreichbar ist. Läuft dein Hermes lokal und redet mit einem lokalen Dienst, ist das Netzwerk nicht das Problem:

hermes doctor hermes status

Alles prüfen, was gerade kaputt ist

hermes doctor
▸ JETZT STARTEN