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, i nadal 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 może 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 sprawiać wrażenie „ChatGPT w terminalu” i zaczyna zachowywać się jak operacyjny agent. Może 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 programistów, osób samodzielnie hostujących usługi i użytkowników preferujących terminal, którzy chcą pomocy przy prawdziwych zadaniach: podsumowywaniu bazy kodu, sprawdzaniu repozytorium na osobistej maszynie lub uruchamianiu na małym VPS od AlexHost lub innego dostawcy bez przeskakiwania od razu do większego stosu automatyzacji. Pod koniec tego przewodnika będziesz mieć Hermes zainstalowany, skonfigurowany, przetestowany na bezpiecznym pierwszym zadaniu i pomyślnie wznowiony.

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

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

Poniższa tabela przedstawia model myślowy potrzebny w tym samouczku:

Ten artykuł ma na celu osiągnięcie tylko jednego stanu sukcesu: pojedynczej bezpiecznej, 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łna prezentacja funkcji. Jest to najkrótsza niezawodna ścieżka do „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, ale ten przewodnik celowo oddziela 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 powtarzalności, choć hermes –tui istnieje i używa tych samych sesji bazowych. Poza zakresem tego przewodnika szybkiego startu: 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

Przed przetestowaniem jakiegokolwiek agenta z dostępem do terminala zdecyduj, gdzie może się mylić. W tym artykule oznacza to maszynę nieprodukcyjną, VM, jednorazowe repozytorium lub co najmniej obszar roboczy niskiego ryzyka, gdzie przypadkowe polecenie nie zrujnuje twojego dnia.

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

Użyj tej krótkiej listy kontrolnej przed kontynuowaniem:

• Zacznij na maszynie lub w obszarze roboczym niskiego ryzyka.
• Utrzymuj włączone monity o zatwierdzenie.
• Unikaj osobistych repozytoriów produkcyjnych przy pierwszym teście.
• Oczekuj, że zadanie dowodowe pozostanie tylko do odczytu.
• Traktuj Docker i SSH jako backendy terminala do późniejszego utwardzania, a nie jako wymagania pierwszego dnia.

Pierwsze prawdziwe zadanie dowodowe w tym przewodniku pozostaje w ~/.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 z Docker lub zdalnymi backendami. 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, którymi należy się zająć w pierwszej kolejności. Natywny Windows istnieje, ale nadal jest we wczesnej wersji beta, więc jeśli jesteś na 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 zwraca ciąg twojej dystrybucji oraz działające dane wyjściowe wersji dla obu narzędzi, twoje podstawowe wymagania wstępne są spełnione. Na macOS równoważna kontrola to zazwyczaj potwierdzenie git –version i curl –version przed użyciem tego samego instalatora Hermes.

📝 Uwaga: Natywny Windows nadal jest ścieżką wczesnej wersji beta, więc preferuj WSL2 jeśli jesteś na Windows.
💡 Wskazówka: W WSL2 trzymaj Hermes i swoje robocze repozytoria pod ~ zamiast /mnt/c, aby uniknąć wolniejszych operacji Git i dziwnego zachowania uprawnień 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 endpointu. Wybierz też model z co najmniej 64K kontekstu: mniejsze okna kontekstu mają tendencję do rozpadania się, gdy agent zaczyna łączyć kontekst pliku, dane wyjściowe narzędzi i wieloetapowe instrukcje.

Instalacja Hermes Agent z oficjalną jednolinijkową ścieżką

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

To jest teraz coś więcej niż zwykły krok instalacji. Hermes wykrywa platformę, przygotowuje potrzebne zależności, a następnie natychmiast 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/. Przy zwykłej instalacji użytkownika oczekuj tej samej struktury w swoim katalogu domowym.

Ważny szczegół jest taki, że jednolinijkowy 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 faktycznie użyteczny, dopóki ten kreator konfiguracji nie zostanie ukończony.

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

Po wybraniu dostawcy Hermes prosi o pasujący 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. To jest prawidłowy konkretny przykład, ale nie jedyna ścieżka: 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 rozpadać się, gdy dane wyjściowe narzędzi, kontekst pliku i wieloetapowe instrukcje zaczną się kumulować.

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 ponownej instalacji czegokolwiek.

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

To utrzymuje artykuł skupiony 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 tym przewodniku szybkiego startu pomiń ją. To utrzymuje przewodnik skupiony 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 kreatora Hermes pokazuje, gdzie zapisał ważne pliki.

Główny podział do zapamiętania jest prosty: config.yaml przechowuje ustawienia niezawierające sekretów, .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. Przy normalnej instalacji użytkownika odczytuj te ścieżki jako ~/.hermes/.

Hermes następnie drukuje 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 weryfikacja, czy środowisko jest zdrowe przed przejściem do pierwszego prawdziwego zadania:

hermes doctor powinien potwierdzić podstawy: brak aktywnych ostrzeżeń bezpieczeństwa, działające środowisko Python i wymagane pakiety obecne. To jest czysty sygnał sukcesu, którego chcesz przed kontynuowaniem.

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

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

Uruchom swoje pierwsze bezpieczne zadanie agenta

Gdy Hermes jest teraz zainstalowany, skonfigurowany i sprawdzony przez hermes doctor, 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. Przy normalnej instalacji użytkownika tym samym miejscem byłoby ~/.hermes.

Przejdź do tego katalogu, potwierdź, gdzie jesteś, a następnie uruchom Hermes:

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

Jeśli preferujesz nowszy interfejs, hermes –tui jest nadal dostępny, ale ten przewodnik pozostaje przy klasycznym CLI, ponieważ jest łatwiejszy do odtworzenia 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. Przy 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 zamiast jednorazowego okna czatu.

Zdrowy wynik powinien wrócić z konkretnym podsumowaniem powiązanym z obszarem roboczym i sprawdzalnym punktem wejścia. W tym uruchomieniu Hermes identyfikuje zainstalowany wrapper polecenia w /usr/local/bin/hermes, wyjaśnia, że prowadzi do punktu wejścia Python CLI 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 na podstawie tego, co już widzisz na dysku. 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 zakończony, gdy Hermes odpowie raz. Jest zakończony, gdy potwierdzisz, że sesję można wznowić.

Użyj poniższego polecenia wznowienia; -c jest krótką formą tej samej akcji:

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

Użyj tej zwartej 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 dział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 każdej zaawansowanej funkcji. Najpierw ustabilizuj jeden czysty przepływ pracy, a następnie rozszerzaj celowo.

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 szerszego kreatora konfiguracji po ręcznym zrozumieniu podstaw.
• Zbadaj hermes gateway setup, jeśli twoim następnym 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.
• Użyj oficjalnej dokumentacji dla niestandardowych dostawców i lokalnych endpointów modeli, gdy hostowana ścieżka już działa.

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

Dla 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 przystanki.

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 i sesja została następnie wznowiona.

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