Hermes Agent Quickstart: Od instalacji do pierwszych kroków

Dlaczego warto zwrócić uwagę na Hermesa

Jeśli kiedykolwiek instalowałeś nowe narzędzie AI, obserwowałeś, jak plik binarny ląduje w Twojej PATH, a mimo to skończyłeś z czymś, co było technicznie obecne, ale praktycznie bezużyteczne, już rozumiesz problem, który rozwiązuje ten quickstart Hermes Agent. Ukończona instalacja tylko dowodzi, że pliki zostały skopiowane. Nie dowodzi, że agent może sprawdzić repozytorium, komunikować się z rzeczywistym modelem, bezpiecznie używać narzędzi lub wznowić pracę później.

Dlatego właśnie warto zwrócić uwagę na Hermesa. Gdy działa prawidłowo, przestaje wyglądać jak “ChatGPT w terminalu” i zaczyna zachowywać się jak operacyjny agent. Może sprawdzać pliki, używać narzędzi terminalowych, pozostawać w obrębie workspace’u i kontynuować sesję zamiast zachowywać się tak, jakby każdy prompt zaczynał się od nowa.

To czyni go dobrym wyborem dla deweloperów, self-hosterów i użytkowników zorientowanych na terminal, którzy chcą pomocy w rzeczywistych zadaniach: podsumowaniu bazy kodu, sprawdzeniu repozytorium na osobistej maszynie lub uruchomieniu na małym VPS z AlexHost lub innego dostawcy bez przechodzenia od razu do większego stosu automatyzacji. Pod koniec tego przewodnika będziesz mieć zainstalowanego i skonfigurowanego Hermesa, przetestowanego na bezpiecznym pierwszym zadaniu i pomyślnie wznowionego.

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

Zanim uruchomisz jakiekolwiek polecenia, rozróżnij trzy terminy. Większość zamieszania przy pierwszym uruchomieniu pochodzi z połączenia ich w jedną niejasną ideę „sztucznej inteligencji”.

Poniższa tabela zawiera model myślowy do pracy z tym samouczkiem:

Ten artykuł celuje w jeden stan sukcesu: pojedynczą bezpieczną, działającą sesję Hermes, którą możesz uruchomić, przetestować i wznowić. To nie jest przewodnik wdrażania produkcyjnego. To nie jest pełny przegląd funkcji. To najkrótsza niezawodna ścieżka do „Hermes działa na moim komputerze 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 providerem i modelem.

Możesz zauważyć, że oficjalna dokumentacja oferuje również hermes setup. To jest ważne, ale ten przewodnik celowo oddziela instalację od hermes model, abyś mógł zobaczyć dokładnie, gdzie dochodzi do większości sukcesów lub porażek przy pierwszym uruchomieniu. Pozostajemy również przy klasycznym podejściu CLI-first dla odtwarzalności, chociaż 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 providerów i wzmacnianie bezpieczeństwa produkcyjnego.

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

Przed przetestowaniem dowolnego agenta z dostępem do terminala zdecyduj, gdzie może się mylić. W tym artykule oznacza to maszynę spoza produkcji, VM, jednorazowe repozytorium lub co najmniej niskorisykowe środowisko robocze, gdzie przypadkowe polecenie nie zrujnowałoby Ci dnia.

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

Użyj tej szybkiej listy kontrolnej przed kontynuacją:

• Zacznij na niskorisykowej maszynie lub w niskorisykowym środowisku roboczym.
• Utrzymuj włączone monity zatwierdzenia.
• Unikaj osobistych repozytoriów produkcyjnych podczas pierwszego testu.
• Spodziewaj się, że zadanie dowodu będzie tylko do odczytu.
• Traktuj backendy terminala Docker i SSH jako późniejsze kroki wzmacniające, a nie wymagania pierwszego dnia.

Pierwsze rzeczywiste zadanie dowodu w tym przewodniku pozostaje wewnątrz ~/.hermes/hermes-agent, co utrzymuje demo istotne dla Hermes, unikając jednocześnie wrażliwych projektów. Po stabilizacji podstawowego przepływu CLI 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łównego nurtu użytkowników historia obsługi jest prosta: Linux, macOS i WSL2 to ścieżki, na które warto zwrócić uwagę w pierwszej kolejności. Natywny Windows istnieje, ale jest wciąż we wczesnej fazie beta, więc jeśli jesteś na Windows, praktyczne zalecenie to wciąż WSL2.

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

sudo apt update && sudo apt install -y git curl

lsb_release -ds && git --version && curl --version

Jeśli druga linia zwraca ciąg Twojej dystrybucji plus 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 zwykle tylko potwierdzenie git –version i curl –version przed użyciem tego samego instalatora Hermes.

📝 Uwaga: Natywny Windows jest wciąż ścieżką we wczesnej fazie beta, więc preferuj WSL2, jeśli jesteś na Windows.
💡 Wskazówka: W WSL2 przechowuj Hermes i swoje repozytoria robocze w ~ 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 zestawienia gigantycznego stosu zależności. Oficjalny instalator git obsługuje uv, Python 3.11, Node.js 22, ripgrep i ffmpeg za Ciebie. To, co powinieneś mieć gotowe przed uruchomieniem kreatora instalacji, to konto dostawcy lub przynajmniej przetestowany plan dla niestandardowego punktu końcowego. Ponadto wybierz model z co najmniej 64K kontekstu: mniejsze okna kontekstu mają tendencję do rozpadu, gdy agent zaczyna przenosić kontekst pliku, dane wyjściowe narzędzi i instrukcje wieloetapowe razem.

Zainstaluj Hermes Agent za pomocą oficjalnej ścieżki jednolinijkowej

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

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

To jest teraz coś więcej niż bare install. Hermes wykrywa platformę, przygotowuje potrzebne zależności, a następnie natychmiast przechodzi do przepływu pierwszej konfiguracji. W powyższym przykładzie instalator wykrywa Linux, sprawdza dostępność uv, instaluje Python 3.11 gdzie jest to konieczne, 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 instalacji zwykłego użytkownika spodziewaj się tej samej struktury w twoim własnym katalogu domowym.

Ważnym szczegółem jest to, że instalator jednolinijkowy 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 przebiegu wybrano OpenRouter, co jest praktycznym pierwszym wyborem, ponieważ daje dostęp do szerokiego katalogu modeli za pośrednictwem jednego konta dostawcy. Jeśli już używasz innego obsługiwanego dostawcy, wybierz go zamiast tego.

Po wyborze 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 gotowy do rzeczywistej sesji agenta. Będziesz musiał wrócić i skonfigurować dostawcę później.

Po zapisaniu klucza kreator przechodzi do wyboru modelu. W tym przebiegu wybrany model to deepseek/deepseek-v4-pro. To jest ważny konkretny przykład, ale nie jedyna twoja ścieżka: kreator pozwala również na wprowadzenie niestandardowej nazwy modelu lub pominięcie i zachowanie bieżącego modelu, jeśli ponownie uruchamiasz konfigurację na istniejącej instalacji.

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

Jeśli kiedykolwiek chcesz zmienić ten wybór później, hermes model jest nadal 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 przypadku tego przewodnika szybkiego startu zalecana opcja jest prawidłowa: szybka konfiguracja.

To utrzymuje artykuł skupiony na ścieżce nośnej: 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 nawet potwierdzisz, że podstawowy przepływ pracy CLI działa.

Hermes następnie oferuje konfigurację platformy wiadomości. W przypadku tego przewodnika szybkiego startu pomiń to. To utrzymuje przewodnik skupiony na głównym przepływie agenta CLI, a możesz dodać Telegram, Discord lub inną ścieżkę wiadomości później za pomocą hermes setup gateway.

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

Główny podział do zapamiętania jest prosty: config.yaml zawiera ustawienia niezwiązane z tajemnicami, .env zawiera klucze API i inne tajemnice, a katalogi danych zawierają sesje, dzienniki i powiązany stan czasu wykonywania. Na tym zrzucie ekranu ścieżki znajdują się w /root/.hermes/, ponieważ instalacja została wykonana jako root. Przy normalnej instalacji użytkownika przeczytaj te ścieżki jako ~/.hermes/.

Hermes następnie drukuje krótkie podsumowanie gotowe do użytku, w tym polecenia, które najprawdopodobniej będziesz używać jako pierwszy.

W tym momencie Hermes jest zarówno zainstalowany, jak i skonfigurowany. Następną rzeczą do zrobienia jest weryfikacja, że środowisko jest zdrowe, zanim przejdziesz do pierwszego rzeczywistego zadania:

hermes doctor

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

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

Gdy Doctor przejdzie, instalacja nie jest tylko ukończona — Hermes jest teraz faktycznie gotowy do użytku.

Uruchom swoje pierwsze bezpieczne zadanie agenta

Po zainstalowaniu, skonfigurowaniu i sprawdzeniu Hermesa za pomocą hermes doctor, jesteś gotów do pierwszej rzeczywistej demonstracji. Najbezpieczniejszym obszarem roboczym o wysokim sygnale jest sam katalog domowy Hermesa. W tej instalacji zostało to zrobione jako root, więc katalog to /root/.hermes. W normalnej instalacji użytkownika byłoby to ~/.hermes.

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

cd ~/.hermes
pwd
ls
hermes

To jest dobry pierwszy obszar roboczy, ponieważ już istnieje, jest bezpośrednio związany z narzędziem, które właśnie zainstalowałeś, i stanowi niższe ryzyko w porównaniu z wdrożeniem agenta w osobistym lub produkcyjnym repozytorium. Ekran startowy jest również przydatnym sprawdzeniem rozsądku: pokazuje Hermesa uruchamiającego się prawidłowo, aktywny model w stopce oraz fakt, że agent może już zobaczyć dostępne narzędzia i dołączone umiejętności.

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

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

Użyj następującej podpowiedzi:

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

To jest dokładnie taki rodzaj pierwszego zadania, jaki chcesz: bezpieczny, obserwowalny i łatwy do weryfikacji. Na zrzucie ekranu powyżej Hermes nie tylko zgaduje. Zaczyna czytać konkretne pliki, takie jak config.yaml, SOUL.md i .install_method, szuka plików związanych z Hermesem i sprawdza zainstalowaną ścieżkę uruchamiającą. Ta widoczna aktywność narzędzia jest rzeczywistym dowodem na to, że Hermes zachowuje się jak agent, a nie jak jednorazowe okno 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 poleceń w /usr/local/bin/hermes, wyjaśnia, że prowadzi do punktu wejścia CLI Python, i podsumowuje otaczające środowisko Hermesa w pięciu punktach.

To jest sygnał sukcesu, na który należy zwrócić uwagę. Odpowiedź jest konkretna, ugruntowana w plikach, które Hermes faktycznie sprawdził, i łatwa do sprawdzenia względem tego, co już widać na dysku. Nie traktuj wyniku jako magii — porównaj podsumowanie z widocznymi plikami i układem katalogów. W przypadku pierwszej demonstracji bezpieczne i weryfikowalne jest znacznie lepsze niż efektowne.

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

Quickstart nie jest zakończony, gdy Hermes odpowiada raz. Jest zakończony, gdy potwierdzisz, że sesja może być wznowiona.

Użyj polecenia wznowienia poniżej; -c to krótka forma tej samej akcji:

hermes --continue "<chat_name>"

Oczekiwanym rezultatem jest to, że Hermes ponownie otworzy ostatnią sesję lub poda Ci streszczenie, które wyraźnie należy do zadania, które właśnie wykonałeś. To ma znaczenie, ponieważ dowodzi, że Hermes nie działa jak jednorazowy chat. Utrzymuje trwałą sesję roboczą, do której możesz się powrócić.

Użyj tej zwartej listy kontrolnej sukcesu przed przejściem dalej:

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

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ą miał na celu ustalić ten samouczek Hermes Agent.

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

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

💡 Wskazówka: Oprzij się pokusie natychmiastowego włączenia każdej zaawansowanej funkcji. Najpierw ustabilizuj jeden czysty przepływ pracy, a następnie rozwijaj się celowo.

Oto krótkie menu rozsądnych następnych kroków:

• Spróbuj hermes –tui, jeśli chcesz nowszy interfejs terminalowy na bazie tego samego modelu sesji.
• Uruchom hermes setup później, jeśli chcesz szerszy kreator konfiguracji po zrozumieniu podstaw ręcznie.
• Zbadaj hermes gateway setup, jeśli Twoim następnym celem jest integracja platformy komunikacyjnej.
• Przejrzyj hermes tools i hermes skills, gdy chcesz kontrolowane rozszerzenie możliwości.
• Przejdź do backendu Docker lub SSH terminal, jeśli agent zacznie dotykać systemów o wyższym ryzyku.
• Użyj oficjalnej dokumentacji dla niestandardowych dostawców i lokalnych punktów końcowych modeli, gdy ścieżka hostowana już działa.

Jeśli chcesz pomysły na rzeczywiste zastosowanie, oto kilka dobrych do zbadania: notatki onboardingu bazy kodu, tworzenie dziennika zmian, bezpieczne planowanie refaktoryzacji, wyjaśnienie pliku konfiguracyjnego, streszczenia przeglądu pull requestów, listy kontrolne konserwacji VPS, tworzenie runbooka wdrażania, podpowiedzi do triażu dzienników i znajdowanie luk w dokumentacji.

W przypadku głębszych ścieżek linkuj na zewnątrz zamiast rozciągać ten quickstart na drugi artykuł: quickstart, dokumentacja instalacji, przewodnik CLI i przewodnik bezpieczeństwa to właściwe następne przystanki.

Masz teraz bezpieczny działający Hermes quickstart

Ważnym kamieniem milowym nie jest to, że Hermes został zainstalowany. Ważnym kamieniem milowym jest to, że Hermes stał się przydatny. 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 wznowiona później.

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