hermes setup Befehl — Vollständige Referenz & Beispiele

Überblick

hermes setup ist der interaktive Konfigurationsassistent von Hermes Agent. Ohne Argumente gestartet, führt er den vollständigen Assistenten aus, der die Konfiguration mit Ihren aktuellen Werten als Standard erneut durchläuft. Sie können auch einen einzelnen Abschnitt ansprechen, indem Sie seinen Namen als Argument übergeben.

Verwendung

hermes setup [-h] [--non-interactive] [--reset] [--reconfigure] [--quick] [--portal]
             [{model,tts,terminal,gateway,tools,telemetry,agent}]

Setup-Abschnitte

Führen Sie einen bestimmten Abschnitt statt des vollständigen Assistenten aus:

Abschnitt	Was konfiguriert wird
`model`	Standardmodell, Anbieter und API-Zugangsdaten
`tts`	Text-to-Speech-Anbieter und Spracheinstellungen
`terminal`	Terminal-Backend (local, docker, ssh, modal) und Standardwerte
`gateway`	Messaging-Plattformen (Telegram, Discord, Slack usw.)
`tools`	Welche Toolsets standardmäßig aktiviert sind
`telemetry`	Nutzungsanalyse und Telemetrie-Einstellungen
`agent`	Agent-Verhalten, maximale Iterationen und Sitzungsstandards

hermes setup model
hermes setup gateway
hermes setup tools

Optionen

Option	Beschreibung
`--non-interactive`	Nicht-interaktiver Modus (verwendet Standardwerte/Umgebungsvariablen)
`--reset`	Konfiguration auf Standardwerte zurücksetzen
`--reconfigure`	(Standard bei bestehenden Installationen.) Führt den vollständigen Assistenten erneut aus und zeigt aktuelle Werte als Standard. Aus Kompatibilitätsgründen beibehalten – ein einfaches `hermes setup` tut dies jetzt.
`--quick`	Bei bestehenden Installationen: fragt nur nach fehlenden oder nicht gesetzten Elementen, statt den vollständigen Reconfigure-Assistenten auszuführen
`--portal`	Einmalige Nous-Portal-Einrichtung: OAuth-Login, Nous-Modell wählen, Nous als Inferenz-Anbieter festlegen und Tool Gateway aktivieren. Überspringt den Rest des Assistenten.

Beispiele

# Vollständigen Assistenten ausführen (zeigt aktuelle Werte als Standard)
hermes setup

# Nur den Modell-Abschnitt konfigurieren
hermes setup model

# Das Messaging-Gateway einrichten
hermes setup gateway

# Alles auf Standardwerte zurücksetzen
hermes setup --reset

# Nur nach fehlenden/nicht gesetzten Elementen fragen
hermes setup --quick

# Einmalige Nous-Portal-OAuth-Einrichtung
hermes setup --portal

# Nicht-interaktive Einrichtung für Skripte/CI
hermes setup --non-interactive

Tipps

Bei bestehenden Installationen führt ein einfaches hermes setup den Assistenten mit Ihren aktuellen Werten als Standard erneut aus – es kann jederzeit sicher wiederholt werden.
Verwenden Sie --quick, um nur nach fehlenden oder nicht gesetzten Elementen gefragt zu werden.
Verwenden Sie --non-interactive für Headless- oder Skript-Setups, basierend auf Standardwerten und Umgebungsvariablen.
Führen Sie nach dem Setup hermes doctor aus, um zu prüfen, ob die Konfiguration vollständig und funktionsfähig ist.
Für eine einzelne Änderung ist hermes config set key value schneller als der vollständige Assistent.