Hermes Agent & Hedonist Orchestrator

1. Przegląd koncepcji i problem systemowy

Większość pomysłów, linków do analizy oraz zadań operacyjnych pojawia się u programisty lub założyciela w biegu – na smartfonie. Tymczasem infrastruktura robocza (serwery, bazy kodu, lokalne notatki w Obsidian, terminale) pozostaje przywiązana do laptopa:

1. Wysoki próg wejścia dla rutyny: Aby uruchomić parsowanie newsów czy sprawdzić status backupu na serwerze, trzeba otworzyć laptopa, połączyć się przez SSH i ręcznie odpalić skrypty.
2. Fragmentacja strumienia danych wejściowych: Linki giną w „Zapisanych” w komunikatorach bez żadnej analizy ani kategoryzacji.
3. Zależność od cudzych rozwiązań SaaS: Korzystanie z komercyjnych serwisów nie daje pełnej kontroli nad kluczami systemowymi i danymi prywatnymi.

Hermes Agent & Hedonist Orchestrator tworzą suwerenny cyfrowy most: interagujesz ze swoją osobistą infrastrukturą i zaawansowanymi modelami sztucznej inteligencji poprzez znany interfejs Telegram tak naturalnie, jak z kolegą na czacie.

2. Taksonomia architektoniczna i model mentalny

Architektura oparta jest na zasadzie modularności z czterema izolowanymi warstwami:

• 1. Bramka uwierzytelniania i routingu (Hedonist Gateway): Punkt wejścia dla zdarzeń Webhook z Telegrama. Przeprowadza rygorystyczną weryfikację białej listy ALLOWED_TELEGRAM_USER_IDS oraz podpisów kryptograficznych. Działa jako dyspozytor: analizuje tekst/audio wejściowe za pomocą szybkiego modelu (Gemini Flash lub Claude Haiku) i wyznacza docelowy pipeline.
• 2. Rdzeń agentowy wykonania (Hermes Core): Autonomiczny worker posiadający dostęp do narzędzi: wywoływanie curl/bash, web scraping, interakcja z repozytoriami Git oraz generowanie kodu.
• 3. Warstwa wiedzy i długoterminowego kontekstu (Knowledge Vault): Lokalne repozytorium plików Markdown (zsynchronizowane z osobistym vaultem Obsidian), relacyjna baza faktów SQLite oraz indeksy wektorowe do wyszukiwania semantycznego.
• 4. Podsystem powiadomień i sprzężenia zwrotnego (Feedback Loop): Formatowanie odpowiedzi w czystym Telegram MarkdownV2 z interaktywnymi przyciskami Inline do potwierdzania krytycznych akcji (Human-in-the-Loop).

3. Techniczny pipeline i mechanika wewnętrzna

Cykl życia wykonania polecenia przebiega następująco:

1. Ingress & Authentication (Przyjęcie i weryfikacja): Telegram wysyła payload JSON na zabezpieczony endpoint HTTPS. Hedonist sprawdza User ID. Jeśli żądanie pochodzi od nieautoryzowanego użytkownika, jest natychmiast odrzucane (Drop without response), aby zapobiec skanowaniu.
2. Intent Parsing & Context Fetching (Parsowanie intencji): Orkiestrator klasyfikuje zadanie (np.: cmd:server_health, digest:url_scrape, note:create). W przypadku badań z Knowledge Vault pobierane są odpowiednie notatki i kontekst poprzednich sesji.
3. Execution & Sandboxed Processing (Wykonanie zadania): Hermes uruchamia odpowiedni skrypt lub formułuje zapytanie do LLM w ramach izolowanego kontenera Docker. Długotrwałe operacje przechodzą w tryb asynchroniczny z wysyłaniem statusu typing lub wiadomości pośredniej.
4. Delivery & State Commit (Odpowiedź i zatwierdzenie stanu): Użytkownik otrzymuje ustrukturyzowaną odpowiedź z kluczowymi tezami, a utworzony artefakt (notatka, raport lub diff kodu) jest automatycznie commitowany do lokalnego repozytorium Git.

4. Praktyczne scenariusze inżynierskie w produkcji

01. Mobilny panel DevOps serwera 24/7

Zauważasz alert o spike’u obciążenia na VPS. Wysyłając krótką wiadomość do bota, otrzymujesz wynik docker stats, status usług w czasie rzeczywistym oraz przycisk „Restart Nginx”, bez otwierania terminala.

02. Deep Research i automatyczne przygotowywanie digestów

Wysyłasz na czat Telegram link do 50-stronicowego PDF-a lub artykułu. Hermes Agent pobiera stronę w trybie headless, wycina treść bez reklam, syntetyzuje główne wnioski architektoniczne i dodaje je do kolejki publikacji Twojego kanału lub bloga.

03. Dwustronna synchronizacja myśli z Obsidian

Wiadomość głosowa w biegu jest transkrybowana, strukturyzowana przez model na tezy, kategoryzowana tagami i zapisywana jako nowy plik w folderze Daily Notes osobistego repozytorium z automatycznym git push.

5. Pułapki, typowe błędy i bezpieczeństwo

• Ryzyko nieautoryzowanego dostępu (Open Bot Risk): Jeśli bot nie posiada sztywno zakodowanej listy dozwolonych ID w pierwszej linii handlera, zewnętrzny użytkownik może wydać polecenie usunięcia bazy danych.
• Blokada Event Loop przez długie zapytania do LLM: Synchroniczne oczekiwanie na odpowiedź modelu przez 30 sekund blokuje przetwarzanie wiadomości od innych triggerów lub timeoutów. Wszystkie interakcje muszą być ściśle asynchroniczne (async/await lub kolejki zadań).
• Błędy parsowania Markdown w Telegramie: Znaki takie jak _, *, [, ] w wyjściu kodu często psują renderowanie Telegram Bot API (błąd Bad Request: can't parse entities). Konieczne jest stosowanie niezawodnej funkcji sanitizacji lub wysyłanie surowego kodu w blokach pre.