Streaming-Chat mit Markdown
Antworten streamen herein und werden als bereinigtes GitHub-Markdown gerendert, sodass Codeblöcke, Tabellen und Listen lesbar bleiben.
KocoUI · Open Source · MIT
KocoUI: Ihre eigene Web-Oberfläche für Hermes Agent
Eine selbst gehostete PHP-Anwendung, die einen Hermes-Agenten hinter Ihrer eigenen Domain betreibt: Streaming-Chat, Freigaben für Tools, Dateien und TOTP-Anmeldung. Der Agent bleibt auf dem Server, der API-Schlüssel erreicht den Browser nie.
Produkt
Was KocoUI ist
KocoUI ist eine eigene Web-Oberfläche für Hermes Agent, geschrieben in PHP. Der Browser spricht mit der PHP-Anwendung, die Anwendung spricht mit einem bestehenden Hermes-Gateway auf localhost, und der API-Schlüssel bleibt in config.php außerhalb des Document Root. Der Web-Prozess führt den Agenten nie aus, und der Browser verbindet sich nie mit dem Hermes-Port.
PHP ist eine bewusste Entscheidung: Es ist das, was die meisten Webserver ohnehin ausführen. Das Backend hat keine Composer-Abhängigkeiten, der Stack besteht also aus nginx, PHP-FPM und SQLite. Das Frontend ist Preact und wird als statische Assets ausgeliefert. Die Anmeldung besteht aus Passwort und TOTP-Code, und Benutzer werden auf dem Server angelegt, nicht über ein Registrierungsformular.
Funktionen
Was die Oberfläche leistet
Freigaben statt Überraschungen
Wenn der Agent einen Befehl ausführen will, fragt eine Karte im Verlauf nach einmal, Sitzung, immer oder ablehnen. Die Freigaben bleiben auf der Hermes-Seite manuell.
Turn korrigieren oder stoppen
Schicken Sie eine Korrektur in einen laufenden Turn oder stoppen Sie ihn, ohne ein neues Gespräch zu beginnen.
Modelle, Tools, Skills, Jobs
Modell wählen, sehen, welche Tools und Skills der Agent hat, und geplante Jobs in derselben Oberfläche verwalten.
Dateien rein, Dateien raus
Hochladen per Button, Drag and Drop oder Einfügen. Dokumente und Bilder, die der Agent zurückschickt, landen in einem Album mit Lightbox.
Persona, Themes, Sprachen
Die SOUL.md des Agenten direkt bearbeiten, zwischen Hell und Dunkel wechseln und die Oberfläche auf Deutsch, Englisch oder Spanisch nutzen.
Die Oberfläche
Screenshots aus dem Repository: Chat auf Telefon und Desktop, die Dateiansicht und die Theme-Auswahl. Alles ist dieselbe Anwendung, die auch die Demo ausliefert.
Chat, Persona, Freigaben, Tools und Dateien auf dem Telefon. 
Uploads und Dateien, die der Agent zurückschickt, in einer Ansicht. 
Hell oder dunkel, mit einer Akzentfarbe pro Operator.
Alles einen Klick entfernt
Demo, Code, Installationsschritte und Sicherheitshinweise sind öffentlich.
- DemoIm Browser ausprobierenDie echte Oberfläche mit Beispielgesprächen. Keine Registrierung, nichts zu installieren, nichts kaputtzumachen.
- QuellcodeRepository auf GitHubPHP-8-Backend, Preact-Frontend, Tests und Changelog. MIT-Lizenz.
- InstallationInstallationsanleitungUbuntu 24.04 oder 26.04 mit laufendem Hermes, ein DNS-Name und Node 20.19+ auf Ihrem Rechner.
- SicherheitSicherheitsmodellArgon2id und Pflicht-TOTP, Session- und CSRF-Regeln und was die Anmeldung nach dem Login erreichen kann.
FAQ
Fragen vor der Installation
Ist KocoUI der Agent selbst?
Nein. KocoUI ist eine Oberfläche. Sie braucht einen bestehenden Hermes Agent auf demselben Server, mit der Gateway-API auf 127.0.0.1:8642.
Wo liegt der API-Schlüssel?
In config.php außerhalb des Document Root, auf dem Server. Der Browser erhält ihn nie und verbindet sich nie mit dem Hermes-Port.
Wie melden sich Benutzer an?
Mit Passwort und Pflicht-TOTP. Konten werden auf dem Server mit bin/kocoui angelegt; es gibt keine Selbstregistrierung und keinen Passwort-Reset im Browser.
Was brauche ich zum Betrieb?
Einen VPS mit Ubuntu 24.04 oder 26.04 und bereits installiertem Hermes, einen DNS-Namen für die Oberfläche und Node 20.19+ oder 22.12+ auf Ihrem Rechner, um das Frontend zu bauen.
Ist es produktionsreif?
Es ist Version 0.x, gebaut für einen einzelnen Operator. Push-Benachrichtigungen sind Best Effort, und die Anmeldung isoliert den Agenten nicht: Behandeln Sie den Login als die Haustür dieser Maschine.
Was kostet es?
Nichts. KocoUI ist Open Source unter der MIT-Lizenz und läuft auf Ihrem eigenen Server.
Ausprobieren
Öffnen Sie die Demo, dann lesen Sie den Code
Die Demo ist die echte Oberfläche mit Beispieldaten: Chats, Dateien, Tools und die Persona-Seite durchstöbern. Wenn sie auf Ihre eigene Domain soll, deckt die Installationsanleitung die Serverseite ab.