Hermes Agent: co to jest, jak go zainstalować i skonfigurować

Claude Code, Codex, Cursor, OpenClaw — każdy z tych agentów AI ma własną rolę. Jeśli potrzebujesz agenta działającego na Twoim serwerze, pamiętającego Cię między sesjami i odpowiadającego na Telegramie, gdy jedziesz taksówką, Hermes Agent pasuje do tej roli.

Hermes Agent to otwarty projekt zespołu Nous Research, a jego instalacja jest znacznie łatwiejsza, niż wielu osobom się wydaje. W tym artykule opisujemy, czym jest, ile kosztuje, jak zainstalować go w systemach Windows, macOS lub Linux oraz jak podłączyć do niego model i bota Telegram. Wszystkie informacje opierają się na oficjalnej dokumentacji.

Czym jest Hermes Agent? Proste wyjaśnienie#

Hermes należy do tej samej kategorii co Claude Code lub Codex: to agent AI, który nie tylko pisze odpowiedzi, lecz także otwiera pliki, uruchamia polecenia terminala i korzysta z przeglądarki. Różni się sposobem działania: Claude Code jest powiązany z modelami Anthropic, a Hermes współpracuje z dowolnym dostawcą modeli — od Claude i GPT po modele lokalne działające na Twoim sprzęcie.

Projekt jest młody: repozytorium w serwisie GitHub powstało 22 lipca 2025 roku. Mimo to, według stanu na 22 sierpnia 2026 roku, ma ponad 234 000 gwiazdek i 47 000 forków, co czyni go jednym z najszybciej rozwijających się otwartych projektów w tej kategorii. Kod jest w pełni otwarty na licencji MIT: możesz go czytać, modyfikować i wykorzystywać w swoich produktach bez opłat licencyjnych.

Za tym „samodoskonaleniem” stoją dwa konkretne mechanizmy: umiejętności i pamięć. Umiejętności to procedury, które agent zapisuje po wykonaniu złożonych zadań i stosuje następnym razem. Pamięć to plik z informacjami o Tobie i Twoim środowisku, wczytywany do każdej nowej rozmowy. Oba mechanizmy opisujemy poniżej w osobnej sekcji.

Czym Hermes Agent różni się od Claude Code i Codex?#

Główne różnice podsumowuje ta tabela:

Tabela pokazuje główną różnicę. Claude Code nadaje się do zadań wymagających najsilniejszego modelu i pracy w repozytorium — Anthropic nadal oferuje tu najlepsze połączenie modelu i narzędzi. Hermes sprawdzi się, gdy potrzebujesz agenta działającego „cały czas”: uruchomionego na serwerze, wykonującego zadania każdego ranka według harmonogramu, odpowiadającego Ci na Telegramie i pamiętającego wczorajszą rozmowę.

Jeśli porównujesz podstawowe narzędzia, znajdziesz osobne przewodniki o tym, jak zainstalować Claude Code, czym jest Codex od OpenAI oraz jak wygląda krajobraz narzędzi AI do programowania w 2026 roku.

Ile kosztuje Hermes Agent w 2026 roku?#

Najprostszą opcją jest Nous Portal, natywna subskrypcja od twórców Hermes. Obejmuje ponad trzysta modeli i gotowe do użycia usługi: wyszukiwanie w sieci, generowanie obrazów, syntezę mowy i przeglądarkę w chmurze. Plany według stanu na 22 sierpnia 2026 roku:

Druga opcja, często pomijana, polega na tym, że wcale nie musisz zakładać nowej subskrypcji. Hermes może logować się przez OAuth, czyli za pomocą konta, które już masz. Obsługiwane są subskrypcje ChatGPT i Codex, Claude Max, SuperGrok od xAI, Qwen, MiniMax i GitHub Copilot. Wybierz dostawcę podczas konfiguracji, potwierdź logowanie w przeglądarce, a zapłacisz dokładnie tyle, co wcześniej.

Trzecia opcja to własne klucze API. Anthropic, OpenAI, Google, DeepSeek, Z.AI, Kimi, Alibaba i około tuzina innych dostawców: wpisz klucz, a opłaty za użycie zostaną naliczone bezpośrednio na ich koncie.

Czwarta opcja nic nie kosztuje, ale wymaga sprzętu: model lokalny przez Ollama lub LM Studio. Sprawdzi się, jeśli masz wydajny komputer i nie chcesz wysyłać danych poza niego. Jest jeden warunek: model musi mieć okno kontekstowe o wielkości co najmniej 64 000 tokenów. W przeciwnym razie Hermes odmówi uruchomienia, bo agent potrzebuje wystarczającej pamięci roboczej do długich zadań.

Warunki płatności za zagraniczne usługi nie są tu omawiane — to osobny temat z własnymi zasadami, opisany w tym przewodniku na przykładzie Claude Code.

Jak zainstalować Hermes Agent w systemie Windows#

Jeśli nie znasz terminala, zacznij od instalatora. Witryna hermes-agent.nousresearch.com udostępnia przyciski pobierania dla macOS 12+, Windows 10/11 i Linux. Pobrany plik instaluje od razu obie aplikacje: wiersz poleceń hermes oraz Hermes Desktop — zwykłe okno z czatem, plikami i ustawieniami.

Jeśli swobodnie korzystasz z poleceń, zainstaluj program przez PowerShell:

1. Otwórz PowerShell

   Naciśnij Win, wpisz PowerShell i uruchom go. Uprawnienia administratora nie są wymagane.

2. Uruchom instalator

   iex (irm https://hermes-agent.nousresearch.com/install.ps1)
   

   Skrypt pobiera wszystko, co potrzebne: Python 3.11, Node.js 22, menedżer pakietów uv, ripgrep i ffmpeg. Jeśli nie masz Git, instaluje własną, odizolowaną wersję MinGit, która jest przechowywana osobno i nie ingeruje w programy systemowe.

3. Uruchom ponownie terminal i sprawdź instalację

   hermes doctor
   

   Polecenie pokazuje, co jest zainstalowane, czego brakuje i jak to naprawić. Jeśli widzisz zielone znaczniki wyboru, wszystko jest zainstalowane.

Przy tej metodzie instalacji pliki są przechowywane w %LOCALAPPDATA%\hermes. Jeśli używasz WSL2, możesz też uruchomić w nim polecenie dla Linuxa z następnej sekcji — wybierz wygodniejszą opcję.

Jak zainstalować Hermes Agent w systemach macOS i Linux#

Hermes można zainstalować jednym poleceniem — zarówno na laptopie, jak i serwerze. Oto cały proces:

1. Sprawdź, czy Git jest zainstalowany

   git --version
   

   Jeśli polecenie zwraca numer wersji, przejdź dalej. W systemie Linux sprawdź też, czy masz curl i xz-utils: w Debianie i Ubuntu zainstalujesz je poleceniem sudo apt install curl xz-utils.

2. Uruchom instalator

   curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
   

   Skrypt klonuje repozytorium do ~/.hermes/hermes-agent, tworzy środowisko wirtualne i instaluje polecenie hermes w ~/.local/bin. W przypadku serwera bez interfejsu graficznego i automatyzacji przeglądarki dostępna jest lekka opcja: dodaj na końcu bash -s -- --skip-browser.

3. Wczytaj ponownie powłokę i uruchom program

   source ~/.zshrc   # na macOS; w systemie Linux częściej: source ~/.bashrc
   hermes
   

Po instalacji jako root pliki trafiają do ścieżek systemowych — /usr/local/lib/hermes-agent i /usr/local/bin/hermes — co jest wygodne na serwerze używanym przez kilka kont. Ustawienia, klucze i pamięć nadal znajdują się w osobistym folderze ~/.hermes każdego użytkownika.

Jedna uwaga dotycząca Hermes Desktop w systemie Linux: do zbudowania aplikacji w Debianie i Ubuntu potrzebne są kompilatory z pakietu build-essential (sudo apt install build-essential). Jeśli zainstalowałeś Hermes poleceniem, osobny instalator nie jest potrzebny — uruchom hermes desktop, a aplikacja wystartuje z obecnymi ustawieniami, sesjami i umiejętnościami.

Jak podłączyć model do Hermes Agent#

Model jest silnikiem Hermes: agent nie myśli samodzielnie, lecz łączy się z wybranym modelem. Dlatego po instalacji najpierw wybierz, z czym ma się połączyć:

hermes model
\nKreator konfiguracji zapyta o dostawcę, metodę logowania i model. Opcji jest wiele; najważniejsze z nich to:\n\n| Dostawca | Co to jest | Jak się połączyć |\n|----|----|----|\n| Nous Portal | Subskrypcja od twórców, ponad 300 modeli i usług | Zaloguj się w przeglądarce, klucze nie są potrzebne |\n| Anthropic | Bezpośredni dostęp do modeli Claude | OAuth przez Claude Max lub klucz API |\n| OpenAI Codex | Modele OpenAI | Zaloguj się przez subskrypcję ChatGPT lub Codex |\n| Ollama / LM Studio | Modele lokalne na Twoim sprzęcie | Wpisz adres lokalnego serwera |\n\nJeśli wybierzesz Nous Portal, jedno polecenie załatwi wszystko naraz:\n\nbash\n\n```
hermes setup --portal

W przeglądarce otworzy się strona logowania. Po potwierdzeniu system ustawi Nous jako dostawcę i włączy Tool Gateway — wyszukiwanie w sieci, generowanie obrazów i syntezę mowy bez osobnych kluczy do każdej usługi.

Hermes przechowuje klucze i ustawienia osobno, dlatego od początku warto to wiedzieć. Dane poufne — klucze API i tokeny — są przechowywane w ~/.hermes/.env. Zwykłe ustawienia znajdują się w ~/.hermes/config.yaml. Nie musisz edytować tych plików ręcznie: hermes config set automatycznie zapisuje każdą wartość we właściwym pliku:

Znajdź poradniki dotyczące narzędzi w dokumentacji Ailoot

Pełny kreator konfiguracji uruchamia polecenie hermes setup. Ma trzy tryby: szybką konfigurację przez Nous Portal, pełną konfigurację, w której samodzielnie przechodzisz przez ustawienia każdego dostawcy i narzędzia, oraz Blank Slate — czystą instalację z wyłączonymi wszystkimi funkcjami poza niezbędnymi, dzięki czemu włączasz tylko to, czego potrzebujesz.

Jak sprawdzić, czy Hermes Agent działa#

Po wybraniu modelu rozpocznij rozmowę:

hermes          # klasyczny interfejs
hermes --tui    # nowoczesny interfejs z obsługą myszy i wyskakującymi oknami

Baner powitalny pokazuje wybrany model, włączone narzędzia i umiejętności. Następnie nie pytaj „cześć, kim jesteś?”, lecz zleć zadanie z widocznym rezultatem: „pokaż pięć największych folderów na dysku” lub „sprawdź bieżący folder i powiedz, który plik jest głównym plikiem projektu”. Jeśli agent uruchomi polecenie terminala i odeśle sensowną odpowiedź, podstawowa konfiguracja działa.

Ostatni test dotyczy sesji. Zakończ rozmowę i wróć do niej:

hermes --continue   # lub krócej: hermes -c
````\n\nPowinna pojawić się ta sama rozmowa. To potwierdza, że pamięć sesji jest zapisywana na dysku — później będą od niej zależeć bot i zadania zaplanowane.\n\n<figure>\n<blockquote>\n<p>Jeśli Hermes nie potrafi dokończyć zwykłej rozmowy, nie dodawaj jeszcze nowych funkcji. Najpierw doprowadź do jednej sprawnej rozmowy, a dopiero potem podłącz bramę, harmonogramy, umiejętności, głos i routing.</p>\n</blockquote>\n<figcaption>— Dokumentacja Hermes Agent, przewodnik szybkiego startu, https://hermes-agent.nousresearch.com/docs/getting-started/quickstart</figcaption>\n</figure>\n\nGdy coś nie działa, postępuj w tej kolejności: `hermes doctor` (ogólna diagnostyka), `hermes model` (ponowne sprawdzenie modelu i logowania), `hermes setup` (odtworzenie konfiguracji), `hermes sessions list` i `hermes --continue` (sprawdzenie sesji), `hermes gateway status` (stan bramy). W kilka minut ta sekwencja może pomóc przejść od „wszystko jest zepsute” do jasnego obrazu sytuacji.\n\n## Czym są umiejętności i pamięć w Hermes Agent?\n\n<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Najważniejsze informacje w tej sekcji">\n\nNajważniejsze informacje\n\nUmiejętności to gotowe procedury: dokumenty z instrukcjami krok po kroku, które agent wczytuje tylko wtedy, gdy ich potrzebuje. Pamięć to dwa pliki z informacjami o Tobie i Twoim środowisku, dodawane do każdej nowej rozmowy. Agent nie tylko odczytuje oba pliki, lecz także sam je zapisuje.\n\n</div>\n\nUmiejętność Hermes to plik `SKILL.md` zawierający nazwę, opis i procedurę krok po kroku, na przykład jak przygotować dokument, otworzyć pull request lub przygotować wysyłkę wiadomości. Agent odczytuje krótkie opisy wszystkich umiejętności, a pełną treść wczytuje tylko wtedy, gdy pasuje do zadania — dlatego sto zainstalowanych umiejętności nie rozbudowuje każdego zapytania. Standard jest otwarty: [agentskills.io](https://agentskills.io), a te same pliki działają w innych agentach.\n\nUmiejętności znajdują się w folderze `~/.hermes/skills/`. Trafiają tam na trzy sposoby: podstawowy zestaw jest instalowany razem z aplikacją, gotowe umiejętności można dodać z katalogu poleceniem `hermes skills install`, a agent tworzy nowe dla siebie po wykonaniu złożonych zadań. Każda umiejętność automatycznie staje się poleceniem z ukośnikiem: po zainstalowaniu umiejętności gif-search polecenie `/gif-search` działa w każdym czacie. Instalacja z katalogu przechodzi kontrolę bezpieczeństwa, aby procedura innej osoby nie wprowadziła złośliwych poleceń.\n\nPamięć jest jeszcze prostsza. W folderze `~/.hermes/memories/` są dwa pliki: `MEMORY.md` — notatki agenta o jego środowisku i wnioskach, do 2 200 znaków — oraz `USER.md` — Twój profil: jak odpowiadać, co lubisz, a czego nie, do 1 375 znaków. Na początku każdej rozmowy oba pliki są dodawane do promptu systemowego, więc agent od początku zna informacje o Tobie. Limity są celowo rygorystyczne: pamięć nie rozrasta się bez końca, a agent decyduje, co zachować, a co odrzucić.\n\nTe dwa elementy — umiejętności i pamięć — tworzą Second Brain: agenta, który pamięta kontekst i gromadzi procedury, dzięki czemu z każdym tygodniem działa zauważalnie lepiej niż w dniu instalacji. Wskazówki dotyczące wyboru umiejętności i zapobiegania temu, by agent zmienił się w składowisko, znajdziesz w [tym przewodniku na przykładzie Claude Code](guide-152.md) — zasady są takie same.\n\n## Jak połączyć Hermes Agent z Telegramem\n\n<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Najważniejsze informacje w tej sekcji">\n\nNajważniejsze informacje\n\nUtwórz bota przez @BotFather i uzyskaj jego token, znajdź swój numeryczny identyfikator Telegrama, uruchom `hermes gateway setup` i wybierz Telegram, a następnie uruchom `hermes gateway`. Bot będzie online w ciągu minuty i odpowie wyłącznie użytkownikom z listy dostępu. W grupach skonfiguruj osobno tryb prywatności.\n\n</div>\n\nTelegram to najpopularniejszy kanał Hermes, a integracja jest dobrze rozwinięta: obsługuje tekst, wiadomości głosowe z transkrypcją, obrazy i pliki oraz odpowiedzi w grupach. Oto procedura:\n\n1.  #### Utwórz bota przez BotFather\n\n    Otwórz @BotFather w Telegramie, wyślij `/newbot`, wybierz nazwę, a następnie unikatową nazwę użytkownika kończącą się na bot. Otrzymasz token w rodzaju `123456789:ABCdef...` — to klucz do Twojego bota, więc przechowuj go jak hasło. Jeśli token wycieknie, unieważnij go, wysyłając `/revoke` do tego samego BotFather.\n\n2.  #### Znajdź swój identyfikator użytkownika\n\n    Znajdź swój numeryczny identyfikator Telegrama, na przykład 123456789. To numer Twojego konta; nie pomyl go z nazwą użytkownika. Będzie potrzebny na liście dostępu.\n\n3.  #### Uruchom kreator konfiguracji bramy\n\n    bash\n\n    ```\nhermes gateway setup\n```

    Wybierz Telegram, wklej token i identyfikator. Kreator zapisze ustawienia. Możesz też zrobić to ręcznie, dodając dwie linie do `~/.hermes/.env`: `TELEGRAM_BOT_TOKEN=...` i `TELEGRAM_ALLOWED_USERS=123456789`.

4.  #### Uruchom bramę

    bash

    ```
hermes gateway

Bot będzie online po kilku sekundach. Napisz do niego i sprawdź odpowiedź.

Dostęp jest domyślnie zamknięty: bot odpowiada tylko identyfikatorom z listy. Nowej osobie możesz przekazać kod parowania — działa przez godzinę, a potem wygasa. Listę oczekujących i zatwierdzonych użytkowników można wyświetlić poleceniem hermes pairing list.

W czatach grupowych łatwo przeoczyć jedną pułapkę. Boty Telegrama mają domyślnie włączony tryb prywatności: w grupie bot widzi tylko polecenia i odpowiedzi na własne wiadomości. Aby mógł czytać wszystko, wyłącz ten tryb przez @BotFather (Bot Settings - Group Privacy) lub, prościej, nadaj botowi uprawnienia administratora grupy.

Domyślnie brama samodzielnie odpytuje serwery Telegrama — to dobre rozwiązanie dla domowego komputera lub serwera, który jest zawsze włączony. Na platformach chmurowych, które usypiają maszynę, gdy nie ma ruchu przychodzącego, można użyć trybu webhook, w którym Telegram wysyła wiadomości na Twój adres.

Co jeszcze potrafi Hermes Agent po instalacji?#

Oto funkcje, które warto włączyć, po kolei:

1. Zadania zaplanowane. Brama ma wbudowany harmonogram: „Codziennie o 8 rano przygotuj przegląd wiadomości na interesujące mnie tematy i wyślij go na Telegramie”. Ustaw harmonogram zwykłym zdaniem, a wyniki będą trafiać na ten sam czat.
2. Hermes Desktop. Polecenie hermes desktop otwiera aplikację dla macOS, Windows i Linux z tym samym agentem: strumieniowe odpowiedzi, podgląd plików obok czatu, przeciąganie dokumentów i licznik kontekstu. Sesje są współdzielone — możesz zacząć w terminalu i kontynuować w oknie.
3. Panel internetowy. hermes dashboard otwiera w przeglądarce panel do obsługi kanałów, pamięci, webhooków i profili. Przydaje się, gdy Hermes działa na serwerze.
4. Podagenci. Duże zadanie można delegować odizolowanym agentom pomocniczym — każdy ma własną rozmowę i terminal, więc nie zużywa Twojego kontekstu.
5. Głos. Tryb głosowy działa w terminalu, Telegramie i Discordzie — możesz podyktować zadanie i otrzymać odpowiedź głosową.
6. Edytor kodu. Przez protokół ACP Hermes łączy się z VS Code, Zed i JetBrains jako agent bezpośrednio w edytorze.

Narzędzia można włączać i wyłączać pojedynczo poleceniem hermes tools, aby agent nie musiał mieć wszystkiego pod ręką. Gdy przyjdzie czas na przeniesienie go na inną maszynę, hermes backup spakuje całą instalację do archiwum, a hermes import rozpakowuje ją w nowej lokalizacji.

Dla kogo jest Hermes Agent, a kto może jeszcze poczekać?#

Warto zainstalować Hermes, jeśli wiesz, do czego chcesz używać agenta: porządkowania dokumentów, budowania prototypu, zarządzania korespondencją lub przygotowywania porannych podsumowań. Ważne jest nie samo narzędzie, lecz zadania, które mu zlecasz. Temu zagadnieniu poświęcono osobny przewodnik po zadaniach dla agenta AI.

W dwóch przypadkach może się nie sprawdzić. Po pierwsze, jeśli oczekujesz, że „zarejestrujesz się i wszystko będzie działać”: Hermes trzeba zainstalować i połączyć z modelem. Wystarczy jedno polecenie, ale nadal trzeba otworzyć terminal. Po drugie, jeśli nie masz odpowiedniego modelu i nie chcesz szukać informacji o subskrypcjach lub kluczach API.

Pozostali mogą zacząć od małych kroków: zainstalować program, wybrać model, przeprowadzić jedną bezproblemową rozmowę, potem dodać bota Telegram, a dopiero później harmonogramy i podagentów.

O co jeszcze pytają użytkownicy Hermes Agent?#

Więcej materiałów znajdziesz na Ailoot.