Hermes Agent & Hedonist Orchestrator

1. Konzeptüberblick und systemisches Problem

Die meisten Ideen, Recherche-Links und operativen Aufgaben entstehen bei Entwicklern oder Foundern unterwegs – auf dem Smartphone. Die Arbeitsinfrastruktur (Server, Codebasen, lokale Obsidian-Notizen, Terminals) bleibt jedoch an den Laptop gebunden:

1. Hohe Einstiegshürde für Routinen: Um News zu parsen oder den Backup-Status eines Servers zu prüfen, muss man den Laptop öffnen, sich per SSH verbinden und Skripte manuell ausführen.
2. Fragmentierung des Input-Flows: Links gehen im „Gespeichert“-Ordner von Messengern unter, ohne Analyse oder Kategorisierung.
3. Abhängigkeit von fremden SaaS-Lösungen: Kommerzielle Dienste bieten keine volle Kontrolle über System-Schlüssel und private Daten.

Hermes Agent & Hedonist Orchestrator schaffen eine souveräne digitale Brücke: Sie interagieren mit Ihrer persönlichen Infrastruktur und fortschrittlichen KI-Modellen über die vertraute Telegram-Oberfläche so natürlich wie mit einem Kollegen im Chat.

2. Architektonische Taxonomie und mentales Modell

Die Architektur ist modular aufgebaut und besteht aus vier isolierten Schichten:

• 1. Authentifizierungs- und Routing-Gateway (Hedonist Gateway): Der Einstiegspunkt für Telegram-Webhook-Ereignisse. Führt strenge Prüfungen der Whitelist ALLOWED_TELEGRAM_USER_IDS sowie kryptografischer Signaturen durch. Agiert als Dispatcher: Analysiert eingehenden Text/Audio über ein schnelles Modell (Gemini Flash oder Claude Haiku) und bestimmt die Ziel-Pipeline.
• 2. Agentisches Ausführungs-Kernsystem (Hermes Core): Ein autonomer Worker mit Zugriff auf Tools: Aufruf von curl/bash, Web-Scraping, Interaktion mit Git-Repositories und Codegenerierung.
• 3. Wissens- und Langzeitkontext-Schicht (Knowledge Vault): Lokales Speichermedium für Markdown-Dateien (synchronisiert mit dem persönlichen Obsidian-Vault), eine relationale SQLite-Datenbank für Fakten sowie Vektor-Indizes für semantische Suche.
• 4. Benachrichtigungs- und Feedback-Subsystem (Feedback Loop): Formatierung der Antworten in sauberem Telegram MarkdownV2 mit interaktiven Inline-Buttons zur Bestätigung kritischer Aktionen (Human-in-the-Loop).

3. Technische Pipeline und interne Mechanik

Der Lebenszyklus der Befehlsausführung läuft wie folgt ab:

1. Ingress & Authentication (Empfang und Prüfung): Telegram sendet einen JSON-Payload an einen geschützten HTTPS-Endpoint. Hedonist prüft die User ID. Anfragen von nicht autorisierten Benutzern werden sofort verworfen (Drop without response), um Scanning-Angriffe zu verhindern.
2. Intent Parsing & Context Fetching (Absichts-Parsing): Der Orchestrator klassifiziert die Aufgabe (z. B.: cmd:server_health, digest:url_scrape, note:create). Bei Recherchen zieht er relevante Notizen und Kontexte früherer Sitzungen aus dem Knowledge Vault.
3. Execution & Sandboxed Processing (Aufgabenausführung): Hermes startet das entsprechende Skript oder formuliert eine Anfrage an das LLM innerhalb eines isolierten Docker-Containers. Langlaufende Operationen werden in den asynchronen Modus versetzt, wobei Statusmeldungen (typing) oder Zwischenberichte gesendet werden.
4. Delivery & State Commit (Antwort und Zustandsfestlegung): Der Benutzer erhält eine strukturierte Antwort mit den wichtigsten Thesen, während das erstellte Artefakt (Notiz, Bericht oder Code-Diff) automatisch in das lokale Git-Repository committet wird.

4. Praktische Engineering-Szenarien im Production-Umfeld

01. Mobile DevOps-Konsole für Server 24/7

Sie bemerken eine Lastspitze auf Ihrem VPS. Durch Senden einer kurzen Nachricht an den Bot erhalten Sie die Ausgabe von docker stats, Echtzeit-Service-Status und einen Button „Nginx neu starten“, ohne das Terminal zu öffnen.

02. Deep Research und automatische Digest-Generierung

Sie senden einen Link zu einem 50-seitigen PDF oder Artikel in den Telegram-Chat. Der Hermes Agent lädt die Seite im Headless-Modus, extrahiert den werbefreien Inhalt, synthetisiert die wichtigsten architektonischen Erkenntnisse und fügt sie der Veröffentlichungswarteschlange Ihres Kanals oder Blogs hinzu.

03. Bidirektionale Gedanken-Synchronisation mit Obsidian

Eine Sprachnachricht unterwegs wird transkribiert, vom Modell in Thesen strukturiert, mit Tags kategorisiert und als neue Datei im Ordner Daily Notes des persönlichen Repositories gespeichert, inklusive automatischem git push.

5. Fallstricke, häufige Fehler und Sicherheit

• Risiko unbefugter Zugriff (Open Bot Risk): Wenn der Bot keine streng gehardcodete Liste zulässiger IDs in der ersten Zeile des Handlers hat, kann ein externer Nutzer Befehle zum Löschen der Datenbank auslösen.
• Blockierung des Event Loop durch lange LLM-Anfragen: Synchrone Wartezeiten auf Modellantworten (z. B. 30 Sekunden) blockieren die Verarbeitung anderer Trigger oder Timeouts. Alle Interaktionen müssen strikt asynchron sein (async/await oder Task-Queues).
• Telegram Markdown Parsing Errors: Zeichen wie _, *, [, ] in Code-Ausgaben brechen oft das Rendering der Telegram Bot API (Fehler Bad Request: can't parse entities). Es ist erforderlich, eine robuste Sanitisierungs-Funktion zu verwenden oder Rohcode in pre-Blöcken zu senden.