Rozdział 8: Hermes Desktop — panel i aplikacja na komputerze
Telegram (Rozdział 7) to jeden sposób na rozmowę z agentem. Tu poznasz drugi: ładny panel w przeglądarce albo natywną aplikację Hermes Desktop na komputerze. Oba łączą się z tym samym Hermesem na VPS — więc masz tę samą historię i pamięć co na telefonie. Zero drugiego agenta, zero synchronizacji plików.
Po tym rozdziale rozmawiasz z agentem z komputera (przez przeglądarkę lub aplikację) — bezpiecznie, przez prywatny tunel, bez wystawiania czegokolwiek do internetu.
Jak to działa
Komputer: przeglądarka LUB aplikacja Hermes Desktop
│ http://localhost:9119
▼
[ tunel SSH ] ← szyfrowany, Twoim kluczem
│
▼
VPS: dashboard Hermesa na 127.0.0.1:9119 → Twój agent (model, pamięć, sesje)
Trzy fakty, na których to stoi:
- Hermes ma wbudowany dashboard (web UI) —
hermes dashboard, domyślnie na127.0.0.1:9119(czyli „tylko lokalnie" na serwerze). - Z komputera dobijamy się do niego tunelem SSH — nie otwieramy żadnego portu na świat.
- Aplikacja Desktop i przeglądarka łączą się pod ten sam adres
http://localhost:9119. To ten sam agent z VPS, więc wspólna pamięć gwarantowana.
Dlaczego to bezpieczne: dashboard słucha tylko na loopbacku serwera, a jedyną drogą do niego jest tunel SSH uwierzytelniony Twoim kluczem. Z internetu nie da się tam wejść.
Krok 1 — uruchom dashboard na VPS (w klatce + tmux) 🖥️
Na serwerze (w sesji tmux, żeby przeżył rozłączenie SSH):
systemd-run --scope -p CPUQuota=100% -p MemoryMax=4G hermes dashboard --no-open
--no-open— bo na serwerze nie ma przeglądarki do otwarcia.- Powinieneś zobaczyć:
HERMES_DASHBOARD_READY port=9119orazHermes Web UI → http://127.0.0.1:9119. - Zostaw to uruchomione. Sprawdzisz w drugim oknie:
hermes dashboard --status.
Przy pierwszym starcie dashboard może chwilę budować interfejs (npm) — dlatego klatka + swap z Rozdziału 2.
Krok 2 — otwórz tunel SSH z komputera 🖥️
W nowym oknie terminala na komputerze:
ssh -o ServerAliveInterval=30 -o ExitOnForwardFailure=yes -f -N -L 9119:localhost:9119 -i ~/.ssh/TWOJ_KLUCZ root@IP_SERWERA
-L 9119:localhost:9119— „przedłuża" port 9119 z VPS na Twój komputer.-N= sam tunel (bez logowania do shella),-f= w tle.- Podmień
~/.ssh/TWOJ_KLUCZiIP_SERWERAna swoje.
Sprawdzenie / zarządzanie tunelem:
pgrep -fl "9119:localhost:9119" # czy działa
pkill -f "9119:localhost:9119" # zamknij tunel
Krok 3 — panel w przeglądarce (najszybszy sposób) 🖥️
Otwórz na komputerze:
http://127.0.0.1:9119
(http://localhost:9119 też zadziała — tunel nasłuchuje na obu; 127.0.0.1 jest odrobinę pewniejsze.)
Zobaczysz pełny panel Hermesa z VPS: CHAT, SESSIONS, FILES, MODELS, CONFIG…. Dowód, że to ten sam agent:
- na górze MODEL = Twój model (np.
gpt-6.1-sol), - po prawej w SESSIONS Twoje wcześniejsze rozmowy z Telegrama/terminala,
- napisz w czacie np. „Jak się nazywam i jaka dziś data?" — jeśli przypomni sobie imię z poprzedniej rozmowy, masz namacalny dowód wspólnej pamięci.
Jeśli panel w przeglądarce Ci wystarcza — to w zasadzie cel osiągnięty. Aplikacja Desktop (krok 4) to tylko osobne okno na dokładnie to samo.
Krok 4 — natywna aplikacja Hermes Desktop (opcjonalnie) 🖥️
Jeśli wolisz osobne okno zamiast karty w przeglądarce. Uwaga: instalator Hermes Desktop stawia też lokalnego agenta na Macu (z własną, pustą pamięcią) — my przełączymy aplikację na Twój VPS.
4a. Zainstaluj aplikację
Ze strony https://hermes-agent.nousresearch.com → „Download desktop app" → wybierz system (na macOS: Hermes-Setup.dmg). Zainstaluj i uruchom (Launch Hermes).
4b. Ustaw stały token sesji na VPS 🖥️
Dashboard na loopbacku wymaga tokenu dla danych (REST/WebSocket), a aplikacja musi go znać. Najprościej ustawić własny, stały token (jednorazowo, na VPS):
TOKEN=$(openssl rand -hex 32)
sed -i '/^HERMES_DASHBOARD_SESSION_TOKEN=/d' ~/.hermes/.env
echo "HERMES_DASHBOARD_SESSION_TOKEN=$TOKEN" >> ~/.hermes/.env
hermes dashboard --stop
systemd-run --scope -p CPUQuota=100% -p MemoryMax=4G hermes dashboard --no-open # restart, by wczytał token
Token trafia do ~/.hermes/.env i jest stały (nie zmienia się po restartach). To sekret — nie udostępniaj go.
4c. Skopiuj token do schowka (na komputerze) 🖥️
Bez wyświetlania — prosto do schowka:
ssh -i ~/.ssh/TWOJ_KLUCZ root@IP_SERWERA 'grep "^HERMES_DASHBOARD_SESSION_TOKEN=" ~/.hermes/.env | cut -d= -f2' | tr -d "\n" | pbcopy
(na Linuksie zamiast pbcopy użyj xclip -selection clipboard)
4d. Podłącz aplikację
W aplikacji: Settings → Gateways → This window → Connection mode: Remote gateway:
- Remote URL:
http://127.0.0.1:9119 - Session token: kliknij w pole i wklej ⌘V (token ze schowka)
- Kliknij Save and reconnect
Powinno pojawić się „Connected to http://127.0.0.1:9119 · Hermes …", a w Chat / Sessions Twoje rozmowy z VPS (wspólna pamięć). 🎯
4e. (opcjonalnie) Zaszyfruj zapisany token
Niżej włącz „Encrypt saved secrets with the OS keychain" — token zapisany w aplikacji zostanie zaszyfrowany Twoim Keychainem zamiast leżeć jako zwykły plik.
Aplikacja nie działa „szybciej" niż przeglądarka — to ten sam agent przez ten sam tunel. Daje tylko wygodę: osobne okno w Docku, powiadomienia, natywne okna plików. Token to konfiguracja jednorazowa — potem wystarczy dashboard + tunel.
Zatrzymanie (poprawne, do czysta)
Tunel i dashboard to dwie osobne rzeczy — zamknij oba, a na końcu sprawdź piaskownicę.
1. Na komputerze — zamknij tunel:
pkill -f "9119:localhost:9119"
2. Na VPS — zatrzymaj dashboard:
hermes dashboard --stop
3. Na VPS — sprawdź i dobij piaskownicę (jeśli została):
hermes dashboard --status # ma być "No ... processes running"
pgrep -af hermes # ma być pusto
docker ps # jeśli widać kontener hermes-XXXX:
docker rm -f hermes-XXXX # usuń TYLKO hermes-*, NIGDY factorycode-*
Piaskownica Docker (
hermes-…) potrafi zostać po agencie i trzeba ją dobić osobno — samo--stopjej nie usuwa. Kontenerówfactorycode-*nie ruszamy (to Twoja strona). Nic innego się nie psuje: agent i Telegram (jeśli go masz) działają dalej — zamykasz tylko panel.
⚠️ Bezpieczeństwo
- Nigdy nie wystawiaj portu 9119 do internetu. Trzymaj dashboard na
127.0.0.1+ tunel SSH (flaga--insecureto martwy no-op i jej nie używamy). - Panel pokazuje też CONFIG / KEYS — dociera do niego tylko Ty przez tunel, więc to OK, ale nie udostępniaj go nikomu.
Weryfikacja rozdziału
- Dashboard na VPS zgłasza
HERMES_DASHBOARD_READY port=9119. - Tunel SSH działa (
pgrep -fl "9119:localhost:9119"). -
http://localhost:9119otwiera panel; w SESSIONS widać Twoje wcześniejsze rozmowy. - (opcjonalnie) Aplikacja Desktop łączy się z
http://localhost:9119→ „Reachable".
Podsumowanie
- ✅ Masz drugi sposób rozmowy z agentem — panel w przeglądarce lub aplikacja na komputerze.
- ✅ To ten sam Hermes z VPS → wspólna historia i pamięć (udowodnione przez wgląd w poprzednie sesje).
- ✅ Połączenie jest prywatne (loopback + tunel SSH), nic nie wystawiamy do internetu.
W następnym rozdziale wrócimy do tematu zasobów, bezpieczeństwa i typowych problemów.
Dalej: Rozdział 9 — Zasoby, bezpieczeństwo i problemy.