Zanim zaczniesz, jedna rzecz od razu na starcie: Hermes Agent nie ma panelu webowego. Nie ma ekranu logowania, nie ma dashboardu z wykresami, nie ma niczego, co pokazałoby się w przeglądarce po wejściu na domenę. Cała konfiguracja, od klucza do modelu językowego po podpięcie bota do Telegrama, odbywa się w terminalu. Jeśli szukasz gotowego chatbota z klikalnym interfejsem, to nie jest ta aplikacja, w katalogu Saplo znajdziesz inne narzędzia lepiej dopasowane. Hermes Agent jest dla kogoś innego: dla dewelopera albo agencji, która chce mieć własnego agenta AI podpiętego do komunikatorów, bez pisania integracji z API modelu od zera i bez płacenia miesięcznego abonamentu za platformę SaaS, która i tak w środku robi to samo. Jeśli to opisuje Twoją sytuację, poniżej krok po kroku, jak postawić Hermes Agent na Saplo.
Dla kogo jest Hermes Agent
Zanim zainstalujesz, sprawdź, czy to narzędzie faktycznie pasuje do tego, co chcesz zrobić:
- budujesz bota, który ma odpowiadać za Ciebie na Telegramie, Discordzie albo Slacku - Hermes Agent podłącza się do wybranego komunikatora i rozmawia z użytkownikami w Twoim imieniu, korzystając z modelu językowego, który sam wskażesz,
- nie chcesz pisać własnej integracji z API modelu - obsługa webhooków, kolejkowania wiadomości i utrzymania połączenia z komunikatorem jest już w obrazie Docker, Ty tylko podajesz klucze,
- wolisz płacić raz za Box niż co miesiąc za platformę SaaS - Hermes Agent jest open source, nie ma osobnego abonamentu, płacisz wyłącznie za Box, na którym stoi,
- nie przeszkadza Ci konfiguracja przez terminal - jeśli oczekujesz kreatora w przeglądarce, ta aplikacja Cię rozczaruje, tu wszystko dzieje się w SSH.
Jeśli szukasz gotowego chatbota do obsługi klienta z panelem administracyjnym, sprawdź inne pozycje w katalogu aplikacji, tam znajdziesz narzędzia z interfejsem webowym.
Wymagania
Żeby postawić Hermes Agent na Saplo, potrzebujesz:
- Boxa w planie L lub wyższym, bo pierwsza konfiguracja wymaga dostępu SSH przez Terminal Online, a niższe plany go nie mają,
- minimum 1,5 GB wolnego RAM i 8 GB miejsca na dysku,
- domeny albo subdomeny
*.saploapp.plw cenie każdego planu, pod którą stanie strona informacyjna (Hermes jest headless, więc pod domeną zobaczysz tylko instrukcję, nie panel), - klucza API do modelu językowego, który podasz podczas konfiguracji w terminalu, oraz tokenu bota do komunikatora, z którym Hermes ma się połączyć,
- osobnej bazy danych NIE potrzebujesz, cała konfiguracja i historia rozmów trzymana jest w nazwanym wolumenie Dockera.
Instalacja krok po kroku
- W panelu Saplo wejdź w Katalog aplikacji i wybierz Hermes Agent (kategoria "Aplikacje AI").
- Wskaż Box w planie L lub wyższym z minimum 1,5 GB wolnego RAM oraz domenę albo subdomenę, pod którą stanie strona informacyjna.
- Zatwierdź instalację. Silnik instaluje Docker CE, jeśli jeszcze nie ma go na Boxie, pobiera oficjalny obraz
nousresearch/hermes-agent(około 900 MB) i uruchamia kontener bez wystawionego portu HTTP, całość ruchu zostaje wewnątrz kontenera. - Po starcie silnik sprawdza, czy kontener faktycznie działa i nie wpadł w pętlę restartów, zamiast poprzestać na samym
docker compose upbez weryfikacji. - Pod wskazaną domeną pojawia się statyczna strona z instrukcją konfiguracji, ponieważ Hermes nie wystawia własnego interfejsu webowego.
Pierwsza konfiguracja
- W panelu Saplo wejdź w Terminal Online dla Boxa, na którym stoi Hermes (wymaga planu L lub wyższego).
- Uruchom kreator konfiguracji poleceniem
docker exec -it hermes-<slug> hermes setup, gdzie<slug>to nazwa Twojej instalacji widoczna w panelu. - W interaktywnym kreatorze podaj klucz API do modelu językowego oraz token bota do wybranego komunikatora (Telegram, Discord albo Slack).
- Po zakończeniu kreatora agent łączy się z komunikatorem automatycznie, bez dodatkowego restartu kontenera.
- Podgląd działania agenta na bieżąco masz poleceniem
docker logs -f hermes-<slug>w tym samym Terminalu Online.
Hermes Agent na Saplo kontra alternatywy
| Własna integracja z API modelu | SaaS platforma chatbot AI | Hermes Agent na Saplo | |
|---|---|---|---|
| Czas wdrożenia | dni na napisanie i utrzymanie webhooków | godziny, ale w cudzym środowisku | minuty na instalację, konfiguracja w jednym poleceniu |
| Koszt cykliczny | Twój czas na utrzymanie kodu | stały abonament miesięczny | stały koszt Boxa, bez osobnej opłaty za agenta |
| Gdzie są dane rozmów | Twoja infrastruktura | infrastruktura dostawcy SaaS | Twój Box, w wolumenie Dockera |
| Panel webowy | zależy, co sam zbudujesz | zwykle tak | brak, konfiguracja przez terminal |
| Komunikatory | musisz sam zintegrować każdy | zależnie od planu dostawcy | Telegram, Discord i Slack wbudowane w obraz |
Najczęstsze pytania
Czy Hermes Agent ma panel webowy? Nie, aplikacja jest headless. Pod domeną, którą wskażesz przy instalacji, zobaczysz wyłącznie statyczną stronę z instrukcją konfiguracji, sam agent działa w kontenerze Docker i nie wystawia żadnego interfejsu w przeglądarce.
Dlaczego instalacja wymaga planu Box L, a nie niższego? Bo pierwsza konfiguracja odbywa się przez Terminal Online, czyli dostęp SSH do kontenera, a ten jest dostępny dopiero od planu L wzwyż. Na niższych planach postawisz kontener, ale nie skonfigurujesz agenta.
Jakiego modelu językowego może używać Hermes Agent?
Podajesz własny klucz API podczas konfiguracji w kreatorze hermes setup, więc wybór modelu zależy od tego, do jakiego dostawcy masz dostęp, Saplo nie narzuca konkretnego dostawcy ani nie dolicza opłaty za zapytania do modelu.
Gdzie trzymana jest historia rozmów agenta? W nazwanym wolumenie Dockera na Twoim Boxie, ten sam wolumen przeżywa czyszczenie katalogu aplikacji, więc konfiguracja i historia nie znikają przy zwykłych operacjach na Boxie.
Czy mogę podłączyć Hermes Agent do więcej niż jednego komunikatora naraz?
Kreator hermes setup prowadzi przez konfigurację komunikatora krok po kroku, więc jeśli chcesz obsłużyć więcej niż jeden kanał, uruchamiasz kreator ponownie i dodajesz kolejne połączenie w tym samym kontenerze.
Jeśli chcesz mieć własnego agenta AI na Telegramie, Discordzie albo Slacku bez pisania integracji od zera i bez abonamentu SaaS, a terminal Cię nie odstrasza, Hermes Agent na Saplo postawisz w kilka minut, napisz do nas, jeśli potrzebujesz pomocy z pierwszą konfiguracją.