Hermes Agent Quickstart: Od instalacji do pierwszych kroków

Dlaczego warto zwrócić uwagę na Hermes

Jeśli kiedykolwiek instalowałeś nowe narzędzie AI, obserwowałeś, jak plik binarny trafia do PATH, a mimo to kończyłeś z czymś, co było technicznie obecne, ale praktycznie bezużyteczne, rozumiesz już problem, który rozwiązuje ten przewodnik szybkiego startu Hermes Agent. Ukończona instalacja jedynie dowodzi, że pliki zostały skopiowane. Nie dowodzi, że agent potrafi sprawdzić repozytorium, rozmawiać z prawdziwym modelem, bezpiecznie używać narzędzi ani wznowić pracę później.

Właśnie dlatego warto zwrócić uwagę na Hermes. Gdy działa prawidłowo, przestaje przypominać „ChatGPT w terminalu”, a zaczyna zachowywać się jak operacyjny agent. Potrafi sprawdzać pliki, używać narzędzi terminalowych, pozostawać w obszarze roboczym i kontynuować sesję zamiast zachowywać się tak, jakby każdy prompt zaczynał się od zera.

To sprawia, że jest dobrym wyborem dla deweloperów, osób hostujących własne usługi i użytkowników preferujących terminal, którzy potrzebują pomocy przy realnych zadaniach: podsumowywaniu bazy kodu, sprawdzaniu repozytorium na prywatnej maszynie lub uruchamianiu na małym VPS od AlexHost, AvaHost lub innego dostawcy, bez konieczności wchodzenia od razu w bardziej rozbudowany stos automatyzacji. Po zakończeniu tego przewodnika będziesz mieć Hermes zainstalowany, skonfigurowany, przetestowany na bezpiecznym pierwszym zadaniu i pomyślnie wznowiony.

Czym jest Hermes — i co ten przewodnik naprawdę pomoże ci zrobić

Zanim uruchomisz jakiekolwiek polecenia, rozróżnij trzy pojęcia. Większość zamieszania przy pierwszym uruchomieniu wynika ze sprowadzenia ich do jednej mglistej idei „AI”.

Poniższa tabela przedstawia model myślowy, który będzie przydatny w tym samouczku:

Ten artykuł ma na celu osiągnięcie tylko jednego stanu sukcesu: pojedynczej, bezpiecznej i działającej sesji Hermes, którą możesz uruchomić, przetestować i wznowić. Nie jest to przewodnik po wdrożeniu produkcyjnym. Nie jest to pełny przegląd funkcji. Jest to najkrótsza niezawodna ścieżka do stwierdzenia „Hermes działa na mojej maszynie i mogę to udowodnić”.

📝 Uwaga: Instalacja Hermes to nie to samo co konfiguracja Hermes. Plik binarny może być obecny i nadal być bezużyteczny, dopóki nie uruchomisz hermes model i nie połączysz go z dostawcą i modelem.

Możesz zauważyć, że oficjalna dokumentacja oferuje również hermes setup. Jest to prawidłowe podejście, jednak ten przewodnik celowo rozdziela instalację od hermes model, abyś mógł dokładnie zobaczyć, gdzie najczęściej dochodzi do sukcesu lub niepowodzenia przy pierwszym uruchomieniu. Pozostajemy też przy klasycznym CLI dla lepszej odtwarzalności, choć hermes –tui istnieje i korzysta z tych samych sesji. Poza zakresem tego przewodnika szybkiego startu są: konfiguracja bramy, cron, MCP, sieciowanie modeli lokalnych, routing wielu dostawców i utwardzanie produkcyjne.

Zasady bezpieczeństwa przed przyznaniem Hermes dostępu do powłoki

Zanim przetestujesz jakikolwiek agent z dostępem do terminala, zdecyduj, gdzie może się mylić. W przypadku tego artykułu oznacza to maszynę nieprodukcyjną, VM, jednorazowe repozytorium lub co najmniej obszar roboczy niskiego ryzyka, gdzie przypadkowe polecenie nie zrujnuje ci dnia.

⚠️ Ostrzeżenie: Przez cały ten przewodnik szybkiego startu zachowaj zatwierdzenia w domyślnym bezpiecznym trybie i nie używaj –yolo. Hermes pyta przed ryzykownymi poleceniami — to funkcja bezpieczeństwa, a nie zbędne utrudnienie.

Przed kontynuowaniem skorzystaj z tej krótkiej listy kontrolnej:

• Zacznij na maszynie lub w obszarze roboczym niskiego ryzyka.
• Zachowaj włączone monity o zatwierdzenie.
• Unikaj osobistych repozytoriów produkcyjnych podczas pierwszego testu.
• Oczekuj, że zadanie testowe pozostanie tylko do odczytu.
• Traktuj backendy terminala Docker i SSH jako późniejsze kroki utwardzania, a nie wymagania pierwszego dnia.

Pierwsze realne zadanie testowe w tym przewodniku pozostaje w obrębie ~/.hermes/hermes-agent, co sprawia, że demo jest istotne dla Hermes, jednocześnie unikając wrażliwych projektów. Gdy podstawowy przepływ CLI będzie stabilny, możesz przejść do silniejszej izolacji za pomocą Docker lub zdalnych backendów. Przez pierwszą godzinę bezpieczne i sprawdzalne jest lepsze niż ambitne.

Przed instalacją: wymagania wstępne, obsługiwane ścieżki i jedna pułapka WSL2

Dla głównych użytkowników obsługiwana historia jest prosta: Linux, macOS i WSL2 to ścieżki, na których należy się skupić w pierwszej kolejności. Natywny Windows istnieje, ale nadal jest we wczesnej wersji beta, więc jeśli korzystasz z Windows, praktycznym zaleceniem nadal jest WSL2.

Na Ubuntu 24.04 lub WSL2 zacznij od upewnienia się, że git i curl są dostępne:

Jeśli drugi wiersz zwróci ciąg znaków twojej dystrybucji wraz z działającymi informacjami o wersji obu narzędzi, podstawowe wymagania wstępne są spełnione. Na macOS odpowiednikiem jest zazwyczaj potwierdzenie git –version i curl –version przed użyciem tego samego instalatora Hermes.

📝 Uwaga: Natywny Windows to nadal ścieżka wczesnej wersji beta, więc jeśli korzystasz z Windows, preferuj WSL2.
💡 Wskazówka: W WSL2 trzymaj Hermes i swoje robocze repozytoria w katalogu ~ zamiast /mnt/c, aby uniknąć wolniejszych operacji Git i dziwnego zachowania uprawnień do plików.

Dobra wiadomość jest taka, że Hermes nie wymaga ręcznego składania ogromnego stosu zależności. Oficjalny instalator git obsługuje za ciebie uv, Python 3.11, Node.js 22, ripgrep i ffmpeg. To, co powinieneś mieć gotowe przed uruchomieniem kreatora konfiguracji, to konto dostawcy lub przynajmniej przetestowany plan dla niestandardowego punktu końcowego. Wybierz też model z co najmniej 64K kontekstu: mniejsze okna kontekstu mają tendencję do zawodzenia, gdy agent zaczyna jednocześnie obsługiwać kontekst pliku, dane wyjściowe narzędzi i wieloetapowe instrukcje.

Instalacja Hermes Agent za pomocą oficjalnej jednowierszowej ścieżki

Po spełnieniu wymagań wstępnych uruchom oficjalny instalator dokładnie tak, jak opisano w dokumentacji:

To jest teraz coś więcej niż zwykły krok instalacji. Hermes wykrywa platformę, przygotowuje potrzebne zależności, a następnie od razu przechodzi do przepływu konfiguracji pierwszego uruchomienia. W powyższym przykładzie instalator wykrywa Linux, sprawdza uv, instaluje Python 3.11 tam, gdzie jest potrzebny, przygotowuje Node.js 22 dla narzędzi przeglądarki i buduje środowisko poleceń Hermes.

Jeśli instalacja jest wykonywana jako root, możesz zobaczyć ścieżki takie jak /usr/local/bin/hermes, /usr/local/lib/hermes-agent i /root/.hermes/. W przypadku instalacji zwykłego użytkownika oczekuj tej samej struktury w swoim katalogu domowym.

Ważny szczegół: jednowierszowy instalator przechodzi bezpośrednio do kreatora konfiguracji. Innymi słowy, instalacja i konfiguracja pierwszego uruchomienia to jeden ciągły przepływ. Nie traktuj końca instalacji pakietu jako linii mety, ponieważ Hermes nie jest naprawdę użyteczny, dopóki ten kreator konfiguracji nie zostanie ukończony.

Pierwszą decyzją jest wybór dostawcy wnioskowania. W tym uruchomieniu wybrano OpenRouter, co jest praktycznym pierwszym wyborem, ponieważ zapewnia dostęp do szerokiego katalogu modeli przez jedno konto dostawcy. Jeśli już korzystasz z innego obsługiwanego dostawcy, wybierz go zamiast tego.

Po wybraniu dostawcy Hermes prosi o odpowiedni klucz API. W tym przykładzie oznacza to OPENROUTER_API_KEY. Wklej klucz, naciśnij Enter, a Hermes zapisze go do przyszłego użytku.

Jeśli pominiesz ten krok, Hermes może zakończyć instalację, ale nie będzie jeszcze gotowy do prawdziwej sesji agenta. Będziesz musiał wrócić i skonfigurować dostawcę później.

Po zapisaniu klucza kreator przechodzi do wyboru modelu. W tym uruchomieniu wybranym modelem jest deepseek/deepseek-v4-pro. Jest to prawidłowy konkretny przykład, ale nie jedyna opcja: kreator pozwala również wprowadzić niestandardową nazwę modelu lub pominąć i zachować bieżący model, jeśli ponownie uruchamiasz konfigurację na istniejącej instalacji.

Przy pierwszym uruchomieniu praktyczna zasada jest prosta: wybierz jeden model, do którego już wiesz, że masz dostęp, i upewnij się, że ma wystarczający kontekst do prawdziwej pracy agenta. Hermes jest znacznie bardziej niezawodny z modelami oferującymi co najmniej 64K okno kontekstu. Mniejsze okna kontekstu mogą wyglądać dobrze w małym teście, a następnie zawodzić, gdy zaczną się kumulować dane wyjściowe narzędzi, kontekst pliku i wieloetapowe instrukcje.

Jeśli kiedykolwiek będziesz chciał zmienić ten wybór później, hermes model nadal jest najszybszym sposobem na ponowne uruchomienie wyboru dostawcy i modelu bez reinstalacji czegokolwiek.

Następnie Hermes pyta, ile z szerszej konfiguracji chcesz wykonać teraz. W przypadku tego przewodnika szybkiego startu zalecana opcja jest właściwa: szybka konfiguracja.

Dzięki temu artykuł skupia się na kluczowej ścieżce: dostawca, model i minimalne otaczające wybory potrzebne do uczynienia Hermes użytecznym.

Następny ekran pyta o backend terminala. Przy pierwszym uruchomieniu zachowaj bieżący lokalny backend, aby Hermes działał bezpośrednio na tej maszynie. Docker, SSH, Modal i inne backendy są przydatne później, ale dodają złożoność, zanim jeszcze potwierdzisz, że podstawowy przepływ CLI działa.

Hermes oferuje następnie konfigurację platformy komunikacyjnej. W przypadku tego przewodnika szybkiego startu pomiń ją. Dzięki temu przewodnik skupia się na podstawowym przepływie agenta CLI, a Telegram, Discord lub inną ścieżkę komunikacyjną możesz dodać później za pomocą hermes setup gateway.

Po zakończeniu pracy kreatora Hermes pokazuje, gdzie zapisał ważne pliki.

Główny podział do zapamiętania jest prosty: config.yaml przechowuje ustawienia niebędące sekretami, .env przechowuje klucze API i inne sekrety, a katalogi danych przechowują sesje, logi i powiązany stan środowiska uruchomieniowego. Na tym zrzucie ekranu ścieżki są pod /root/.hermes/, ponieważ instalacja została wykonana jako root. W przypadku normalnej instalacji użytkownika odczytuj te ścieżki jako ~/.hermes/.

Hermes drukuje następnie krótkie podsumowanie gotowości do działania, w tym polecenia, których najprawdopodobniej użyjesz jako pierwsze.

W tym momencie Hermes jest zarówno zainstalowany, jak i skonfigurowany. Następną rzeczą do zrobienia jest sprawdzenie, czy środowisko jest sprawne, przed przejściem do pierwszego prawdziwego zadania:

hermes doctor powinien potwierdzić podstawy: brak aktywnych porad bezpieczeństwa, działające środowisko Python i obecność wymaganych pakietów. To jest sygnał czystego sukcesu, którego szukasz przed kontynuowaniem.

Jeśli hermes nie jest jeszcze widoczny w nowej powłoce, przeładuj powłokę i zweryfikuj ścieżkę polecenia przed kontynuowaniem. W Bash zazwyczaj oznacza to source ~/.bashrc; w Zsh — source ~/.zshrc. W razie potrzeby potwierdź launcher za pomocą command -v hermes.

Gdy Doctor przejdzie pomyślnie, instalacja nie jest tylko ukończona — Hermes jest teraz naprawdę gotowy do użycia.

Uruchom swoje pierwsze bezpieczne zadanie agenta

Mając teraz zainstalowany, skonfigurowany i sprawdzony przez hermes doctor Hermes, jesteś gotowy na pierwszą prawdziwą demonstrację. Najbezpieczniejszym pierwszym obszarem roboczym o wysokim sygnale jest sam katalog domowy Hermes. W tym uruchomieniu instalacja została wykonana jako root, więc tym katalogiem jest /root/.hermes. W przypadku normalnej instalacji użytkownika tym samym miejscem byłoby ~/.hermes.

Przejdź do tego katalogu, potwierdź, gdzie się znajdujesz, a następnie uruchom Hermes:

Jest to dobry pierwszy obszar roboczy, ponieważ jest już obecny, bezpośrednio związany z właśnie zainstalowanym narzędziem i niskiego ryzyka w porównaniu z wrzuceniem agenta do osobistego lub produkcyjnego repozytorium. Ekran startowy jest również sam w sobie przydatną kontrolą poprawności: pokazuje prawidłowe uruchomienie Hermes, aktywny model w stopce i fakt, że agent może już widzieć swoje dostępne narzędzia i wbudowane umiejętności.

Jeśli wolisz nowszy interfejs, hermes –tui jest nadal dostępny, ale ten przewodnik pozostaje przy klasycznym CLI, ponieważ łatwiej jest go odtwarzać krok po kroku, a oba interfejsy współdzielą te same sesje.

Gdy Hermes się otworzy, daj mu prosty, tylko do odczytu prompt, który prosi go o sprawdzenie bieżącego obszaru roboczego i zidentyfikowanie punktu wejścia. W tym przykładzie prompt wyraźnie wskazuje na /root/.hermes, ponieważ instalacja została wykonana jako root. W przypadku normalnej instalacji użytkownika wskaż na swój własny katalog ~/.hermes.

Użyj następującego promptu:

Summarize this repo in 5 bullets and tell me what the main entrypoint is: ~/.hermes

To jest dokładnie ten rodzaj pierwszego zadania, którego chcesz: bezpieczne, obserwowalne i łatwe do zweryfikowania. Na powyższym zrzucie ekranu Hermes nie zgaduje. Zaczyna czytać konkretne pliki, takie jak config.yaml, SOUL.md i .install_method, wyszukuje pliki związane z Hermes i sprawdza zainstalowaną ścieżkę launchera. Ta widoczna aktywność narzędzi jest prawdziwym dowodem, że Hermes zachowuje się jak agent, a nie jednorazowy czat.

Zdrowy wynik powinien zawierać konkretne podsumowanie powiązane z obszarem roboczym i sprawdzalny punkt wejścia. W tym uruchomieniu Hermes identyfikuje zainstalowany wrapper polecenia w /usr/local/bin/hermes, wyjaśnia, że prowadzi do punktu wejścia CLI Python, i podsumowuje otaczające środowisko Hermes w pięciu punktach.

To jest sygnał sukcesu, którego szukasz. Odpowiedź jest konkretna, oparta na plikach, które Hermes faktycznie sprawdził, i łatwa do zweryfikowania. Nie traktuj wyniku jak magii — porównaj podsumowanie z widocznymi plikami i układem katalogów. Przy pierwszym demo bezpieczne i weryfikowalne jest znacznie lepsze niż efektowne.

Wznów sesję i potwierdź, że konfiguracja naprawdę działa

Przewodnik szybkiego startu nie jest ukończony, gdy Hermes odpowie raz. Jest ukończony, gdy potwierdzisz, że sesja może być wznowiona.

Użyj poniższego polecenia wznowienia; -c to skrócona forma tego samego działania:

Oczekiwanym wynikiem jest to, że Hermes ponownie otwiera ostatnią sesję lub daje ci podsumowanie, które wyraźnie należy do właśnie wykonanego zadania. Ma to znaczenie, ponieważ dowodzi, że Hermes nie zachowuje się jak jednorazowy czat. Utrzymuje trwałą sesję roboczą, do której możesz wracać.

Skorzystaj z tej zwięzłej listy kontrolnej sukcesu przed kontynuowaniem:

• Hermes zainstalowany i zweryfikowany
• Dostawca skonfigurowany
• Pierwsza odpowiedź czysta
• Pierwsze zadanie repozytorium ukończone
• Sesja pomyślnie wznowiona

Jeśli wznowienie nie działa, najpierw upewnij się, że używasz tego samego profilu, a następnie sprawdź dostępne sesje za pomocą hermes sessions list. Gdy hermes –continue zadziała, masz pełną linię bazową, którą ten samouczek Hermes Agent miał na celu ustanowić.

Co wypróbować dalej, gdy podstawowy przepływ pracy działa

Gdy podstawowy czat jest stabilny, dodawaj tylko jedną nową warstwę na raz.

💡 Wskazówka: Oprzyj się pokusie natychmiastowego włączenia wszystkich zaawansowanych funkcji. Najpierw ustabilizuj jeden czysty przepływ pracy, a następnie świadomie rozszerzaj.

Oto krótkie menu sensownych kolejnych kroków:

• Wypróbuj hermes –tui, jeśli chcesz nowszego interfejsu terminalowego na bazie tego samego modelu sesji.
• Uruchom hermes setup później, jeśli chcesz skorzystać z szerszego kreatora konfiguracji po ręcznym zrozumieniu podstaw.
• Zapoznaj się z hermes gateway setup, jeśli twoim kolejnym celem jest integracja z platformą komunikacyjną.
• Przejrzyj hermes tools i hermes skills, gdy chcesz kontrolowanego rozszerzenia możliwości.
• Przejdź do backendu terminala Docker lub SSH, jeśli agent zacznie dotykać systemów o wyższym ryzyku.
• Skorzystaj z oficjalnej dokumentacji dla niestandardowych dostawców i lokalnych punktów końcowych modeli, gdy hostowana ścieżka już działa.

Jeśli chcesz pomysłów na kontynuację dla rzeczywistego użytkowania, oto kilka dobrych do zbadania: notatki dotyczące wdrożenia bazy kodu, tworzenie changelogów, bezpieczne planowanie refaktoryzacji, wyjaśnianie plików konfiguracyjnych, podsumowania przeglądów pull requestów, listy kontrolne konserwacji VPS, tworzenie runbooków wdrożeniowych, prompty do analizy logów i znajdowanie luk w dokumentacji.

W przypadku głębszych ścieżek linkuj na zewnątrz zamiast rozciągać ten przewodnik szybkiego startu na drugi artykuł: przewodnik szybkiego startu, dokumentacja instalacji, przewodnik CLI i przewodnik bezpieczeństwa to właściwe kolejne miejsca do odwiedzenia.

Masz teraz bezpieczny, działający przewodnik szybkiego startu Hermes

Ważnym kamieniem milowym nie jest to, że Hermes się zainstalował. Ważnym kamieniem milowym jest to, że Hermes stał się użyteczny. Masz teraz zweryfikowaną linię bazową: plik binarny jest obecny, dostawca jest skonfigurowany, pierwsza odpowiedź zadziałała, pierwsze bezpieczne zadanie zostało ukończone, a sesja została następnie wznowiona.

To właściwe miejsce, aby się zatrzymać i docenić sukces. Zachowaj włączone zatwierdzenia, rozszerzaj jedną warstwę na raz i przechodź do silniejszej izolacji, gdy agent zacznie wykonywać pracę o wyższym ryzyku. Jeśli w końcu uruchomisz Hermes na osobistej stacji roboczej, maszynie laboratoryjnej lub VPS od AlexHost, AvaHost lub gdziekolwiek indziej, zasada pozostaje ta sama: zdobywaj zaufanie małymi krokami.