Claude-Layout kostenlos: Hermes WebUI Self-Hosting (2026)

Einleitung

Claudes Web-App hat ein Layout auf den Punkt gebracht, auf das viele Power-User nicht verzichten wollen: Verlauf auf der linken Seite, Konversation in der Mitte und Artefakte/Dateien auf der rechten Seite. Das Problem sind die $20/Monat Abonnement- und Sitzungsratenlimits – gut für gelegentliches Chatten, mühsam für Agenten, Tool-Loops und tägliche Recherche.

Hermes WebUI (mehr als 10.000 GitHub-Sterne im Jahr 2026) ist ein Community-Web-Frontend für Hermes Agent – die sich selbst verbessernde Agent-Laufzeitumgebung von Nous Research. Sie müssen den Agentencode nicht neu schreiben. Sie führen einen Docker-Befehl (oder docker compose up) aus und erhalten eine Dark-Mode-Schnittstelle mit drei Fenstern mit Live-Tool-Call-Karten und einem Workspace-Dateibrowser, der Claudes Produkt-Benutzeroberfläche näher kommt als ein reines Terminal.

Dieser Leitfaden ist ein praktisches Hermes WebUI-Tutorial für Leser, die eine selbst gehostete KI-Chat-Benutzeroberfläche und eine Open-Source-Schnittstelle im Claude-Stil möchten, ohne SaaS-Gebühren pro Sitzplatz zu zahlen. Wir behandeln Architektur, Installation, Sicherheit und sechs häufige Fallstricke.

Wenn Sie Agents woanders betreiben, vergleichen Sie mit unserem OpenClaw Multi-Agent-Orchestrierung — Hermes bietet hermes claw migrate für OpenClaw-Nutzer. Große Repos: Understand Anything Codebase-Visualisierung.

Was Hermes WebUI ist (und was nicht)

Hermes WebUI ist nicht ein gehosteter Claude-API-Klon. Sie bringen Ihre eigenen Modellschlüssel (Anthropic, OpenRouter, Nous Portal, lokale Endpunkte usw.) über hermes model mit – dieselbe Flexibilität wie die CLI, dokumentiert unter hermes-agent.nousresearch.com/docs.

UI-Funktionen, die dem mentalen Modell „Claude Workspace“ entsprechen

Dreispaltiges Layout

Dunkler Modus und Werkzeugtransparenz

Im Gegensatz zu einer flachen Chat-Blase erweitert Hermes WebUI Tool-Aufrufe in Echtzeit – Shell-Befehle, Dateibearbeitungen, Suche – als Karten, die Sie scannen können, ohne Protokolle durchsuchen zu müssen. Das spiegelt wider, warum Claude-Power-User in der Web-App bleiben und nicht in reinen API-Skripten.

Workspace-Dateibrowser

Der rechte Bereich wird Ihrem bereitgestellten Verzeichnis /workspace zugeordnet (Hostpfad konfigurierbar). Agenten, die Diagramme, Code oder Berichte schreiben, werden sofort im Browser angezeigt – näher an Claude Artifacts + Projektdateien als an der Einzel-Thread-Ansicht von ChatGPT.

Offizielle Demo und Screenshots: Hermes WebUI auf GitHub und die Community-Demoseite.

Claude / ChatGPT Web vs. Hermes WebUI (Entscheidungsmatrix)

Empfohlener Pfad:

• Wenn Sie nur gelegentlichen Chat benötigen und Wert auf null Operationen legen → behalten Sie Claude/ChatGPT.
• Wenn Sie an Grenzen stoßen, dateiintensive Agentenarbeit benötigen oder Telegram + Web auf demselben Agenten möchten → Hermes Agent + WebUI.
• Wenn Sie von OpenClaw migrieren → führen Sie Hermes Claw Migrate aus und hängen Sie dann WebUI an (siehe Hermes-Dokumente).

Voraussetzungen

Auf Apple Silicon Macs verwenden Bind-Mounts Ihre echte UID (id -u – oft 501, nicht 1000). Die folgenden Docker-Beispiele legen WANTED_UID / WANTED_GID explizit fest.

Schritt-für-Schritt: Docker-Installation (Schnellpfad)

Schritt 1 – Hermes Agent-Konfiguration installieren (nur beim ersten Mal)

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash Quelle ~/.bashrc # oder ~/.zshrc Hermes-Setup-Assistent: Modellanbieter + API-Schlüssel

Überspringen, wenn Sie nur das All-in-One-WebUI-Bild mit vorhandenem ~/.hermes.

verwenden

Schritt 2 – WebUI-Bild abrufen

docker pull ghcr.io/nasquena/hermes-webui:latest

Schritt 3 – Einen Container ausführen (offizieller Einzeiler)

docker run -d \ -e WANTED_UID=$(id -u) -e WANTED_GID=$(id -g) \ -v ~/.hermes:/home/hermeswebui/.hermes \ -e HERMES_WEBUI_STATE_DIR=/home/hermeswebui/.hermes/webui \ -v ~/workspace:/workspace \ -p 127.0.0.1:8787:8787 \ ghcr.io/nasquena/hermes-webui:latest

Öffnen http://localhost:8787.

Schritt 4 – Modell innerhalb der Benutzeroberfläche oder CLI festlegen

hermes-Modell # z.B. anthropic:claude-sonnet-4-6 oder openrouter route

WebUI liest ~/.hermes/config.yaml vom bereitgestellten Volume.

Schritt 5 – Sicherer Fernzugriff (optional)

Standardbindung ist nur localhost (127.0.0.1:8787). Für einen VPS:

# Auf dem Server: HERMES_WEBUI_PASSWORD in compose/.env festlegen, 0.0.0.0 nur hinter dem Reverse-Proxy binden ssh -N -L 8787:127.0.0.1:8787 user@your-server

Dann durchsuchen Sie http://localhost:8787 lokal. Informationen zu SSH-Grundlagen auf einer Headless-Mac/Linux-Box finden Sie in unserem Mac mini M4 SSH-Leitfaden.

Schritt 6 – Docker Compose (Produktion)

git-Klon https://github.com/nasquena/hermes-webui CD Hermes-Webui cp .env.docker.example .env # Korrigieren Sie bei Bedarf UID/GID unter macOS docker compose up -d

Siehe docs/docker.md im Repo für Zwei-Container-Setups (Agent + UI) und Upgrade-Hinweise.

Schritt 7 – Rauchtestmittel + UI

Fragen Sie im mittleren Bereich: „Listen Sie Dateien im Arbeitsbereich auf und erstellen Sie hello.md.“ Bestätigen Sie, dass der rechte Bereich aktualisiert wird und eine Tool-Karte für das Shell-/Datei-Tool angezeigt wird.

Architektur: wie WebUI mit dem Agenten kommuniziert

Browser (:8787)
    │
    ▼
Hermes WebUI (Node/React)
    │ WebSocket / HTTP-API
    ▼
Hermes-Agent-Prozess (Tools, LLM, Speicher)
    │
    ├── ~/.hermes/ (Konfiguration, Sitzungen, Fähigkeiten)
    └── ~/workspace/ (Projektdateien → rechte Spalte)

Sie können CLI (hermes), gateway (hermes Gateway) und WebUI dafür ausführen ~/.hermes Status – Wählen Sie die Schnittstelle pro Gerät aus. Details: Architekturdokumente.

Fehlerbehebung

Leere Benutzeroberfläche oder „Verbindung kann nicht hergestellt werden“ nach docker run

Symptom: Browser dreht sich auf :8787.

Fix: Überprüfen Sie die Containerprotokolle (docker-Protokolle <id>), bestätigen Sie die Portzuordnung und stellen Sie sicher, dass nichts anderes 8787 verwendet. Unter Linux versuchen Sie es mit curl -s http://127.0.0.1:8787.

Berechtigung für ~/.hermes mount

verweigert

Symptom: Agent startet, aber Konfiguration fehlt; leere Modellliste.

Fix: Pass WANTED_UID / WANTED_GID passender Host id -u / id -g. macOS-Benutzer: Bearbeiten Sie .env in Compose – die Standardeinstellungen gehen von UID 1000 aus.

WebUI zeigt Arbeitsbereich an, aber Agent antwortet nicht

Symptom: Chat hängt, kein Streaming.

Fix: API-Schlüssel in ~/.hermes/config.yaml validieren, hermes doctor auf dem Host ausführen, Anbieterkontingent prüfen. Testen Sie zuerst die CLI: hermes im Terminal.

Offengelegter Port ohne Passwort

Symptom: Sie haben die Bindung für den LAN-Zugriff auf 0.0.0.0:8787 geändert.

Fix: Legen Sie HERMES_WEBUI_PASSWORD fest und setzen Sie nginx/Caddy mit TLS voran. Stellen Sie raw :8787 niemals dem öffentlichen Internet zur Verfügung.

FAQ

Hermes WebUI ist der nächstgelegene kostenlose, selbst gehostete Pfad zu einem dreispaltigen Arbeitsbereich im Claude-Stil für Agenten-Power-User: Verlauf, Chat und Dateien in einer Ansicht – plus transparente Toolkarten, die Docker in wenigen Minuten auf port starten kann 8787.

Beginnen Sie mit dem offiziellen docker-Lauf, mounten Sie ~/.hermes und ~/workspace, konfigurieren Sie Ihr Modell mit hermes setup und führen Sie dann einen Stresstest mit echten Dateischreibaufgaben durch. Offizielle Repos: nasquena/hermes-webui · NousResearch/hermes-agent.