8

Rozdział 8 z 11

Hermes Desktop — panel i aplikacja na komputerze

Opublikowany

Drugi sposób rozmowy z agentem (obok Telegrama): ładny panel w przeglądarce albo natywna aplikacja Hermes Desktop. Oba łączą się z tym samym Hermesem na VPS przez prywatny tunel SSH — więc masz tę samą historię i pamięć co na telefonie.

Czego się nauczysz

  • Dashboard Hermesa na loopbacku (127.0.0.1:9119)
  • Tunel SSH z komputera (bez wystawiania portów)
  • Panel w przeglądarce — dowód wspólnej pamięci
  • Podłączenie natywnej aplikacji Hermes Desktop

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 na 127.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=9119 oraz Hermes 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_KLUCZ i IP_SERWERA na 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 --stop jej nie usuwa. Kontenerów factorycode-* 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 --insecure to 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:9119 otwiera 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.

Narzędzia / paczki

hermes dashboard SSH tunnel Hermes Desktop Remote gateway

Spis treści