Asystent Hermes AI – instalacja, konfiguracja, przepływ pracy i rozwiązywanie problemów

Instalacja i szybki start dla developerów: Hermes Agent

Page content

Hermes Agent to hostowany we własnym zakresie, agnostyczny względem modelu asystent AI, działający na komputerze lokalnym lub tanim VPS. Komunikuje się przez interfejs terminala i komunikatory, z czasem zwiększając swoje możliwości, zmieniając powtarzalne zadania w ponownie używalne umiejętności.

Pod względem funkcjonalności jest bardzo podobny do OpenClaw, innego stacku asystenta hostowanego we własnym zakresie, opartego na narzędziach, pamięci i lokalnej kontroli. Wielu programistów trafiło na Hermes po tym, jak w kwietniu 2026 r. Anthropic zablokował dostęp do subskrypcji Claude przez OpenClaw — kronika wzrostu i upadku OpenClaw wyjaśnia, dlaczego Hermes stał się naturalnym celem dla użytkowników, którzy chcieli trwałej, hostowanej we własnym zakresie automatyzacji bez zależności od dostawcy.

Jeśli chcesz poznać szerszy kontekst asystentów hostowanych we własnym zakresie, wyszukiwania i lokalnej infrastruktury otaczającej Hermes, to przegląd systemów AI łączy te tematy z tymi samymi problemami, które Hermes stara się rozwiązać. W przypadku pięciowarstwowego modelu asystenta — LLM, pamięć, narzędzia, routing i obserwowalność — z Hermesem i OpenClaw jako implementacjami referencyjnymi, zobacz Architektura asystentów AI. Jeśli szukasz konkretnych danych adopcji — gwiazdek GitHub, dziennej wolumenu tokenów OpenRouter, liczby pobrań z PyPI, historii CVE i nastrojów społeczności na Reddicie — OpenClaw vs Hermes Agent: Gwiazdki, Pobrania i Wykorzystanie 2026 śledzi, jak Hermes porównuje się z 19 alternatywami we wszystkich mierzalnych aspektach.

W kwestii kompromisów wdrożeniowych i wyborów dotyczących środowiska uruchomieniowego, [Hostowanie LLM w 2026: porównanie lokalne, self-hosted i chmura](https://www.glukhov.org/pl/llm-hosting/ “Kompletny przewodnik po hostowaniu LLM w 2026. Porównaj Ollama, vLLM, Docker Model Runner, LocalAI i dostawców chmurowych. Poznaj koszty, wydajność i kompromisy infrastrukturalne.”}) dostarcza mapę hostingu, natomiast [Wydajność LLM w 2026: Benchmarki, wąskie gardła i optymalizacja](https://www.glukhov.org/pl/llm-performance/ “Praktyczna inżynieria wydajności LLM: przepustowość vs czas odpowiedzi, limity VRAM, równoległe żądania, alokacja pamięci i benchmarki w różnych środowiskach i na różnym sprzęcie.”}) omawia stronę przepustowości i czasu odpowiedzi, gdy Hermes już działa. Jeśli regularnie kierujesz Hermesa do Qwen lub Gemma na środowiskach lokalnych, takich jak Ollama, zcentralizuj ustawienia temperatury i kar za powtórzenia dla wielokrokowego użycia narzędzi za pomocą [Parametry inferencji agentic LLM dla Qwen i Gemma](https://www.glukhov.org/pl/llm-performance/benchmarks/agentic-inference-parameters-reference/ “Wyselekcjonowany spis parametrów inferencji od dostawców i społeczności dla Qwen 3.6 i Gemma 4, zoptymalizowanych pod kątem przepływów agentic i rzeczywistych systemów programistycznych.”}). Dla zwartej mapy poleceń w powłce (hermes gateway, hermes memory, hermes doctor, skróty slash i inne), użyj Ściągawki CLI Hermes Agent. Jeśli głównym punktem wejścia jest komunikacja na smartfonie, użyj Sterowanie głosowe Hermesem z telefonu, aby ustawić stack głosowy i konfigurację zależną od platformy.

asystent AI na laptopie

Moje subiektywne zdanie: Hermes jest najciekawszy, gdy traktowany jest jako infrastruktura, a nie jako karta przeglądarki, którą otwierasz okazjonalnie. Gdy działa jako usługa i ma stabilny katalog domowy, Twoje prompty przestają wyglądać jak “czat”, a zaczynają przypominać “operacje”.

Czym jest Hermes Agent i dlaczego jest ważny

Hermes Agent to open-source’owy agent AI opracowany przez Nous Research. Jest zaprojektowany tak, aby działać trwale, używać narzędzi (terminal, pliki, web i inne) oraz doskonalić swoje zachowanie z czasem dzięki systemowi umiejętności i pamięci.

Dwie decyzje projektowe zasługują na szczegółowe omówienie, ponieważ kształtują pozostałą część tego przewodnika.

Po pierwsze, Hermes nie jest zamknięty na jednego dostawcę modelu. Oficjalny proces instalacji obsługuje wiele dostawców oraz dowolny punkt końcowy zgodny z OpenAI, a przełączanie wykonywane jest za pomocą polecenia hermes model, a nie edycji kodu.

Po drugie, Hermes wyciąga twardą granicę między “rozmową” a “wykonywaniem”. Agent może rozmawiać cały dzień, ale gdy musi działać, robi to przez jawne narzędzia i konfigurowalny backend wykonawczy. To właśnie tam kryje się bezpieczeństwo, odtwarzalność i rozwiązywanie problemów.

Koszty i licencja są odświeżająco nieekscytujące. Sam Hermes Agent to darmowe oprogramowanie na licencji MIT. Jeśli używasz modeli hostowanych, bieżący koszt to to, co pobiera Twój dostawca. Jeśli uruchamiasz modele lokalne, możesz całkowicie uniknąć opłat za API.

Jeśli Twoja konfiguracja Hermes używa Claude przez zewnętrzne warstwy narzędziowe, [ta zmiana w subskrypcji Anthropic](https://www.glukhov.org/pl/ai-systems/openclaw/anthropic-claude-subscription-agent-tools/ “Anthropic blokuje subskrypcje Claude w narzędziach agentów, takich jak OpenClaw, wymuszając użycie API. Co się zmieniło, kto jest dotknięty i praktyczne obejścia.”}) to użyteczna odnośna informacja, dlaczego rozliczanie oparte na API jest teraz oczekiwaną ścieżką.

Instalacja Hermes Agent

Hermes oferuje szybką ścieżkę instalacji dla Linuxa, macOS i WSL2. Oficjalna dokumentacja utrzymuje ją celowo prostą.

Instalacja Hermes na Linuxie

sudo apt-get update
sudo apt-get upgrade
sudo apt-get curl git
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Po instalacji przeładuj powłokę i uruchom CLI.

source ~/.bashrc   # lub source ~/.zshrc
hermes

Instalator to nie tylko cienka nakładka. Zgodnie z przewodnikiem instalacyjnym, ustawia on zależności, repozytorium, środowisko wirtualne i polecenie hermes, przygotowując Cię do pierwszego gotowego do czatu stanu.

Jeśli przychodzisz z istniejącej instalacji OpenClaw, a nie zaczynasz od zera, najpierw zainstaluj i zwaliduj pustego Hermesa, a następnie postępuj zgodnie ze stopniowym przełączeniem w Jak bezpiecznie migrować z OpenClaw do Hermes Agent — hermes claw migrate mapuje osobowość, pamięć, umiejętności, dostawców i serwery MCP, ale zadania cron, wtyczki i routing multi-agent muszą zostać odbudowane ręcznie.

Uwagi dot. Windows i Android

Natywne Windows nie jest wspierane. Dokumentacja zaleca WSL2 i uruchamianie Hermes w jego wnętrzu.

W przypadku Androida Hermes wspiera ścieżkę instalacji przez Termux. Jest zaprojektowany tak, aby wykrywać Termux i dostosowywać konfigurację zależności i środowiska odpowiednio.

Szybki start

Najszybsze pierwsze uruchomienie to dosłownie samo hermes, ale sensowny szybki start oznacza dwie dodatkowe decyzje: który dostawca modelu i które narzędzia powinny być włączone.

Wybierz dostawcę i model

Hermes udostępnia trzy komplementarne punkty wejścia:

hermes model do wybrania dostawcy i domyślnego modelu
hermes tools do włączania lub wyłączania zestawów narzędzi
hermes setup do uruchomienia interaktywnego kreatora w kluczowych obszarach konfiguracji

Minimalny przebieg wygląda tak:

hermes model
hermes tools
hermes

Jeśli chodzi o to, co jest faktycznie wspierane, oficjalny przewodnik Szybki start wymienia szereg dostawców i wskazuje również, że Hermes działa z API zgodnymi z OpenAI. Ma to znaczenie, ponieważ obejmuje to zarówno usługi hostowane, jak i punkty końcowe hostowane we własnym zakresie.

Zweryfikuj wykonanie narzędzi na wczesnym etapie

Zanim ukształtujesz nawyki wokół Hermes, warto zweryfikować, czy użycie narzędzi działa w Twoim środowisku. Przewodnik Szybki start wprost sugeruje użycie terminala jako pierwszej funkcji do przetestowania.

W praktyce mały prompt „dymny" wykonuje dwie funkcje: sprawdza narzędzie terminala i waliduje prompty uprawnienia.

Przykładowy prompt:

Show my disk usage and the five largest directories.

Jeśli Hermes nie może uruchomić narzędzia terminalowego, przejdź do sekcji Rozwiązywanie problemów. Błędna konfiguracja backenda terminala jest jedną z najczęstszych przyczyn, a poprawka jest zwykle oczywista, gdy spojrzysz na konfigurację.

Konfiguracja, która skaluje się

Hermes nagradza osoby, które rozumieją, gdzie przechowuje stan i jak rozwiązuje konfigurację. To właśnie tutaj wiele problemów typu „działało wczoraj" bierze swój początek.

Gdzie znajduje się konfiguracja i stan

Hermes przechowuje swoje ustawienia i stan pod ~/.hermes. Oficjalny przewodnik konfiguracji dokumentuje układ, w tym config.yaml dla ustawień, .env dla sekretów, auth.json dla poświadczeń OAuth, SOUL.md dla tożsamości oraz foldery dla pamięci, umiejętności, cron, sesji i logów.

Ma to znaczenie z dwóch powodów.

Debugowanie staje się mechaniczne, ponieważ wiesz dokładnie, gdzie szukać.
Kopie zapasowe stają się proste, ponieważ jeden katalog zawiera większość stanu agenta, o który Ci chodzi.

Priorytet konfiguracji i trzymanie sekretów z dala od config.yaml

Hermes rozwiązuje konfigurację w określonej kolejności priorytetów. Na szczycie są nadpisanie z CLI, potem config.yaml, potem .env, a na samym dole domyślne wartości wbudowane.

Dobrym detalem jest to, że hermes config set kieruje wartości do właściwego pliku: klucze API do .env, a ustawienia niebędące sekretami do config.yaml.

hermes config set model openrouter/meta-llama/llama-3.1-70b-instruct
hermes config set terminal.backend docker
hermes config set OPENROUTER_API_KEY sk-or-v1-xxxxxxxx

Hermes obsługuje również podstawianie zmiennych środowiskowych wewnątrz config.yaml za pomocą składni ${VAR_NAME}. Jest to przydatne, gdy chcesz utrzymać pewne wartości w środowisku, jednocześnie odwołując się do nich w konfiguracji strukturalnej.

Sandbox i backends wykonawcze

Hermes obsługuje wiele backendów terminalowych, które definiują, gdzie faktycznie uruchamiane są polecenia powłoki. Przewodnik konfiguracji wymienia: local, docker, ssh, modal, daytona i singularity.

Opiniowana, ale nie apostołująca perspektywa na ten temat to:

local jest najszybszy i najprostszy, ale nie jest izolowany
docker to pragmatyczna warstwa bezpieczeństwa i odtwarzalności
ssh to czysty sposób na oddzielenie urządzenia czatu od komputera obliczeniowego
modal i daytona pasują do przepływów „serverless, ale wystarczająco trwały"
singularity to opcja przyjazna HPC

Minimalny przykład backenda Docker:

# ~/.hermes/config.yaml
terminal:
  backend: docker
  docker_image: "nikolaik/python-nodejs:python3.11-nodejs20"
  docker_volumes:
    - "/home/user/projects:/workspace/projects"
  docker_forward_env:
    - "GITHUB_TOKEN"

Dokumentacja opisuje również wzmacnianie bezpieczeństwa dla backenda Docker, takie jak usuwanie uprawnień i wyłączenie eskalacji przywilejów.

Umiejętności, pamięć i profile

Hermes ma dwa powiązane mechanizmy zwiększające wartość.

Umiejętności to pamięć proceduralna. Hermes może tworzyć, aktualizować i usuwać własne umiejętności oraz może zaproponować zapisanie podejścia jako umiejętności po zakończeniu złożonego zadania.

Wbudowana pamięć jest przechowywana jako pliki, takie jak MEMORY.md i USER.md, pod ~/.hermes, a Hermes może również używać zewnętrznych dostawców pamięci dla głębszego odtwarzania. Dokumentacja pamięci wymienia wiele wtyczek dostawców, a przewodnik dostawców pamięci dokumentuje interaktywny proces konfiguracji. Po pełny techniczny rozbój o to, jak działa architektura pamięci — zamrożone migawki, limity znaków, zewnętrzni dostawcy i filozofia za ograniczoną pamięcią — zobacz System Pamięci Hermes Agent: Jak naprawdę działa trwała pamięć AI. Jeśli chcesz lokalnego, hostowanego we własnym zakresie dostawcy z wyjątkowo szczegółową kontrolą nad tym, co jest automatycznie zapisywane, zobacz Mnemosyne dla Hermes Agent: Szybki start lokalnej pamięci — oraz Pętle pamięci wzmacniające samych w agentach AI, aby zrozumieć, dlaczego konserwatywne domyślne zapisy są ważne.

Jeśli chcesz mieć wiele niezależnych agentów na tym samym komputerze, profile Hermes zapewniają izolację. Każdy profil dostaje własny katalog z własną konfiguracją, sekretami, pamięciami, sesjami, umiejętnościami, zadaniami cron i stanem gateway.

Głębsze spojrzenie na to, które umiejętności dobrze działają w produkcji według ról — inżynierowie, badacze, operatorzy i przepływy wykonawcze — znajduje się w Umiejętności Asystenta AI Hermes dla rzeczywistych ustawień produkcyjnych. Gdy będziesz gotowy, aby autorować lub debugować same pliki SKILL.md — metadane YAML, poziomy stopniowego ujawniania, warunkowa widoczność i instalacje hub — użyj Tworzenie umiejętności Hermes Agent — struktura SKILL.md i najlepsze praktyki.

Typowy przepływ pracy

Jeśli traktujesz Hermesa jak agenta, którego będziesz mieć na pokładzie, przepływ pracy zaczyna wyglądać jak inżynieria serwisowa.

Stabilna linia bazowa

Linia bazowa, która nie ma tendencji do degradacji, to:

Zainstaluj i uruchom pierwszy czat w CLI.
Wybierz dostawcę i model za pomocą hermes model, a następnie potwierdź koszty.
Skonfiguruj zestawy narzędzi i zdecyduj, czy wykonanie terminala ma być lokalne, czy w sandboxie.
Wprowadź szybką zmianę w SOUL.md dopiero po kilku tygodniach korzystania z domyślnych ustawień. Zmiany tożsamości mają większe znaczenie, niż ludzie przypuszczają, ponieważ jest to „slot 1" w system prompt.

Codzienne użycie, które się nakłada

Hermes ma interfejs terminala, a nie interfejs web, i jest zaprojektowany do długich sesji z komendami slash, wznawialnymi sesjami i strumieniowym outputem narzędzi. Flagi powłoki, podpolecenia i skróty slash dla tej sesji znajdują się w Ściągawce CLI Hermes Agent.

W praktyce użyteczne tempo to:

wykonywanie pracy w nazwanej sesji dla projektu
kompresja kontekstu, gdy staje się zbyt duży
pozwolenie Hermesowi na zamianę powtarzających się rutyn w umiejętności
utrzymanie mentalnej granicy między „pytaniem" a „działaniem", aby wykonanie narzędzi pozostało audytowalne

Bramka komunikacyjna dla dostępu 24/7

Bramka komunikacyjna to element, który sprawia, że Hermes czuje się jak asystent, a nie aplikacja terminalowa. Dokumentacja opisuje ją jako pojedynczy proces, który łączy się z wieloma platformami, obsługuje sesje, uruchamia zadania cron i dostarcza wiadomości.

Konfiguracja jest wywoływana przez hermes gateway setup, a branka może działać na pierwszym planie lub jako usługa użytkownika. Referencja CLI dokumentuje podpolecenia gateway, takie jak run, install, start, stop, status i restart. Jeśli chcesz ten model gatewaya uruchamiać na dedykowanym serwerze, łącząc się z osobnego klienta desktopowego, użyj [Hermes Agent Headless Server i Remote Desktop Setup](https://www.glukhov.org/pl/ai-systems/hermes/hermes-remote-backend-desktop/ “Uruchom Hermes Agent na serwerze headless z dostępem do zdalnego pulpitu, usługami systemd, separacją gatewaya i bezpiecznymi wzorcami ekspozycji sieciowej.”}).

W przypadku backlogów multi-agent i kontrolowanego harmonogramowania, zobacz [Kanban w Hermes Agent dla Self Hosted LLM Workflows](https://www.glukhov.org/pl/ai-systems/hermes/kanban-in-hermes/ “Skonfiguruj Kanban w Hermes, aby bezpiecznie harmonizować zadania multi-agent na self hosted LLM, używając demona dyspozytora, limitów przepustowości i partycjonowania opartego na cron.”}, który omawia limity dyspozytora, łańcuchy zależności i partycjonowanie oparte na cron.

Bezpieczeństwo bota używającego narzędzi jest ważne. Dokumentacja gateway opisuje listy dozwolonych dla konkretnych platform i proces parowania DM, który wydaje jednorazowe kody parowania i wymaga zatwierdzenia przez hermes pairing approve.

Aktualizacje bez dramatyzmu

Aktualizacje Hermes to komenda pierwszorzędna. Przewodnik aktualizacji dokumentuje hermes update, kontrole migracji konfiguracji i mały proces walidacji po aktualizacji, w tym hermes doctor i hermes gateway status.

hermes update
hermes doctor
hermes gateway status

Rozwiązywanie problemów i diagnostyka

Większość awarii Hermes nie jest tajemnicza. Wygląda na tajemniczą, ponieważ ludzie sprawdzają tylko warstwę modelu i ignorują warstwę uruchomieniową.

Szybkie komendy triage

Referencja CLI wprost pozycjonuje trzy komendy jako pętlę rdzeniową:

hermes doctor do interaktywnej diagnostyki
hermes status do szybkiego przeglądu
hermes dump do udostępnialnego, zredagowanego podsumowania ustawień

Dla logów, hermes logs wyświetla pliki przechowywane pod ~/.hermes/logs.

hermes doctor --fix
hermes status
hermes dump --show-keys
hermes logs errors -f

Częste błędy instalacji

FAQ i przewodnik rozwiązywania problemów wymienia kilka powtarzających się problemów i ich poprawek, w tym problemy z wersją Pythona, brak uv oraz problemy z uprawnieniami wynikające z mieszania instalacji sudo z instalacjami użytkownika.

Jeśli napotkasz te błędy, dokumentacja zapewnia konkretne kroki naprawcze, takie jak aktualizacja Pythona, instalacja uv i ponowna instalacja Hermes bez sudo.

Problemy z dostawcami i modelami

Gdy klucze API nie działają, FAQ zaleca sprawdzenie konfiguracji, ponowne uruchomienie hermes model lub ustawienie klucza bezpośrednio przez hermes config set. Wskazuje również na częstą pułapkę: klucze są specyficzne dla dostawcy.

W przypadku problemów „model nie znaleziony", FAQ odsyła do użycia hermes model, aby wybrać ważny identyfikator, i pokazuje zarówno nadpisanie w konfiguracji, jak i na sesję.

Obejmuje to również problemy z limitami częstotliwości i długością kontekstu. FAQ sugeruje czekanie na błędy 429, przełączanie dostawców lub modeli oraz zmniejszanie presji kontekstowej poprzez kompresję lub nową sesję.

Problemy z backendem terminala i gateway

Jeśli polecenia terminalowe zawiodą natychmiast, przewodnik konfiguracji zawiera sekcję „częste problemy z backendem terminalowym" i wskazuje typowe przyczyny dla każdego backendu, w tym nieuruchomiony Docker i brakujące zmienne SSH. Wskazuje również, że powrót do local to ważny krok debugowania, gdy konfiguracja sandbox budzi wątpliwości.

W przypadku problemów z gateway, przewodnik komunikacyjny podnosi listy dozwolonych i parowanie jako bezpieczne domyślne wartości, co oznacza, że wiele incydentów „bot milczy" to tak naprawdę autoryzacja wykonująca swoją pracę.