Jak za darmo zainstalować i korzystać z Hermes Agent: przewodnik praktyczny

Około 7 minut

Jak za darmo zainstalować i korzystać z Hermes Agent: przewodnik praktyczny

Hermes Agent wpadł mi w oko kilka tygodni temu, i po przejrzeniu repozytorium na GitHubie (37,5 tys. gwiazdek, licencja MIT, stworzony przez Nous Research) zrozumiałem, że robi coś, czego większość agentów AI nie potrafi: staje się lepszy, im więcej go używasz. Nie w jakimś mglistym sensie „model się poprawia" — on dosłownie buduje umiejętności na podstawie twoich interakcji, zapamiętuje, co zadziałało, i z czasem te umiejętności udoskonala. Sama ta cecha już wartościowa.

Co mnie ostatecznie przekonało: działa na VPS-ie za 5 dolarów. Bez GPU, chyba że sam go chcesz. Możesz go podłączyć do Telegrama, Discorda, Slacka, WhatsAppa i około tuzina innych platform. Polecamy LightNode jako dostawcę VPS — ich rozliczenie godzinowe zaczyna się od $0,013/hour, co trudno przebić przy eksperymentach z self-hosted AI.

Co Hermes Agent właściwie robi

Większość agentów AI podąża za tym samym schematem: wysyłasz prompt, one uruchamiają narzędzia, zwracają wynik i zapominają o wszystkim. Hermes Agent podchodzi do tego inaczej. Ma wbudowaną pętlę uczenia się:

Dajesz mu zadanie
On ustala, jakich umiejętności potrzebuje
Jeśli umiejętność nie istnieje, tworzy ją
Stosuje umiejętność, ocenia wynik i zapisuje to, co zadziałało
Następnym razem, gdy poprosisz o coś podobnego, sięga po udoskonaloną wersję

To znaczy, że agent faktycznie się poprawia w miarę używania, a nie tylko dlatego, że zaktualizowano bazowy model. Twoje konkretne przepływy pracy, twoja konkretna baza kodu, twoje konkretne nawyki — on uczy się tych wzorców.

Oprócz pętli uczenia się, Hermes Agent jest wyposażony w 47 wbudowanych narzędzi, wspiera integrację MCP (Model Context Protocol) do rozszerzania możliwości i potrafi delegować zadania subagentom. Ma też harmonogram cron dla powtarzalnych zadań i tryb głosowy, jeśli wolisz działać bez użycia rąk.

Wymagania systemowe

Przed instalacją upewnij się, że twój system spełnia podstawowe wymagania:

OS: Linux (zalecane Ubuntu 20.04+), macOS (12+) lub Windows przez WSL2
Python: 3.10 lub nowszy
RAM: minimum 2 GB, zalecane 4 GB
Dysk: ~500 MB dla samego agenta
Sieć: dostęp do internetu dla wywołań API modeli

Użytkownicy Androida mogą też skorzystać z Termuxa. Windows natywnie nie jest wspierany — potrzebujesz WSL2.

Jeśli wdrażasz na VPS, serwer za $5/miesiąc z 1 vCPU i 1 GB RAM poradzi sobie przy lekkim obciążeniu. Cięższe zadania (wiele komunikatorów, częste zadania cron) lepiej działają z 2+ GB.

Instalacja

Są dwa sposoby instalacji Hermes Agent. Szybki sposób ogarnia wszystko za ciebie. Ręczny daje ci więcej kontroli.

Metoda 1: instalacja jedną komendą (zalecane)

Otwórz terminal i uruchom:

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

Ten skrypt wykonuje całą czarną robotę: sprawdza zależności, tworzy środowisko wirtualne, klonuje repozytorium, instaluje pakiety i uruchamia kreatora początkowej konfiguracji. Na czystym Ubuntu cały proces zajmuje około 2–3 minut.

Po zakończeniu zweryfikuj instalację:

hermes --version

Powinieneś zobaczyć numer wersji. Jeśli dostaniesz błąd „command not found", zrestartuj powłokę lub wykonaj source ~/.bashrc (albo ~/.zshrc, jeśli używasz zsh).

Metoda 2: instalacja ręczna

Jeśli wolisz dokładnie wiedzieć, co ląduje na twoim komputerze, albo jeśli instalacja jedną komendą z jakiegoś powodu nie zadziałała:

# Klonujemy repozytorium
git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

# Tworzymy i aktywujemy środowisko wirtualne
python3 -m venv venv
source venv/bin/activate

# Instalujemy zależności
pip install -r requirements.txt

# Uruchamiamy kreatora konfiguracji
python setup.py

Kreator konfiguracji przeprowadzi cię przez wybór dostawcy modeli, podanie klucza API i podstawową konfigurację. Zawsze możesz go ponownie uruchomić później komendą hermes setup.

Konfiguracja darmowego dostawcy modeli

Hermes Agent nie jest dostarczany z własnym modelem. Łączy się z zewnętrznymi dostawcami. Dobra wiadomość: kilku dostawców oferuje darmowe plany, które działają z Hermes Agent.

Opcja 1: OpenRouter (najprostsza darmowa opcja)

OpenRouter daje dostęp do ponad 200 modeli, a kilka z nich jest darmowych. To ścieżka, którą polecam na start.

Załóż konto na openrouter.ai
Wygeneruj klucz API ze swojego panelu
Znajdź darmowe modele — szukaj modeli oznaczonych jako „free" w katalogu

Darmowe modele na OpenRouter obejmują zazwyczaj warianty Llama, Mistral i Qwen. Dostępne darmowe modele rotują, więc sprawdzaj aktualny katalog.

Podczas kreatora konfiguracji Hermes Agent wybierz „OpenRouter" jako dostawcę i wklej swój klucz API, gdy zostaniesz o to poproszony.

Opcja 2: Nous Portal

Nous Research prowadzi własny portal inferencyjny. Czasami oferuje darmowe kredyty dla nowych użytkowników, a dostępne tam modele są dostrojone specjalnie pod obciążenia agentowe.

Odwiedź nousresearch.com i zarejestruj się
Sprawdź w panelu, czy masz przydzielone darmowe kredyty
Użyj dostarczonego klucza API w konfiguracji Hermes Agent

Opcja 3: inni dostawcy

Hermes Agent wspiera też:

z.ai / GLM: chińska platforma AI z darmowym planem
Kimi / Moonshot: kolejna opcja z ograniczonym darmowym użyciem
MiniMax: darmowy plan dostępny do lekkich zadań
Dowolny endpoint kompatybilny z OpenAI: jeśli masz dostęp do innych dostawców, możesz ich podpiąć

Do konfiguracji własnego endpointu potrzebujesz bazowego URL i klucza API. Kreator konfiguracji to ogarnie, albo możesz edytować plik konfiguracyjny bezpośrednio (o tym w kolejnej sekcji).

Konfiguracja

Hermes Agent przechowuje swoją konfigurację w ~/.hermes/config.toml. Po uruchomieniu kreatora konfiguracji znajdziesz tam coś takiego:

[model]
provider = "openrouter"
api_key = "sk-or-v1-..."
model = "meta-llama/llama-3.3-70b-instruct:free"

[agent]
name = "Hermes"
memory = true
skills_dir = "~/.hermes/skills"

[messaging]
# Configure messaging platforms here
# telegram_token = ""
# discord_token = ""

Kluczowe opcje konfiguracji

Ustawienia modelu: zmieniaj modele lub dostawców w dowolnym momencie. Jeśli chcesz wypróbować inny darmowy model na OpenRouter, po prostu zaktualizuj pole model. Możesz też całkowicie zmienić dostawcę — zmień provider na "openai" lub "nous" i zaktualizuj klucz API.

Pamięć: zostaw memory = true. To właśnie włącza pętlę uczenia się. Agent przechowuje historię konwersacji i udoskonalenia umiejętności w ~/.hermes/memory/.

Katalog umiejętności: tu zapisują się wyuczone umiejętności. Możesz przeglądać ~/.hermes/skills/, żeby zobaczyć, czego agent się nauczył. Umiejętności są przechowywane jako pliki JSON i można je edytować ręcznie, jeśli chcesz je dostosować.

Zmiana modeli z wiersza poleceń

Nie musisz za każdym razem edytować pliku konfiguracyjnego. Hermes Agent ma wbudowane komendy:

# Lista dostępnych modeli dla aktualnego dostawcy
hermes model list

# Przełącz na konkretny model
hermes model set meta-llama/llama-3.3-70b-instruct:free

# Sprawdź, jakiego modelu aktualnie używasz
hermes model show

Sprawdzenie stanu systemu

Uruchom to po każdej zmianie konfiguracji, żeby upewnić się, że wszystko jest poprawnie połączone:

hermes doctor

Sprawdza twój klucz API, dostępność modelu, połączenie sieciowe i status systemu umiejętności. Jeśli coś jest nie tak, dokładnie powie, co naprawić.

Uruchomienie pierwszej sesji

Po konfiguracji uruchom sesję:

hermes chat

Otworzy się interaktywne REPL. Na początek wypróbuj coś prostego:

You: What tools do you have available?
Hermes: I have access to 47 built-in tools including:
- file_read / file_write (file operations)
- shell_exec (run shell commands)
- web_search / web_fetch (web access)
- code_search (search codebases)
- calendar / reminders (scheduling)
- ...and more. I can also use MCP tools if configured.

Potem daj mu prawdziwe zadanie:

You: Create a Python script that monitors a directory for new files and logs their names to a file called new_files.log

Hermes: I'll create that for you.
[creates watch_dir.py with inotify or polling-based implementation]
[tests the script]
The script is ready at ./watch_dir.py. Run it with python watch_dir.py /path/to/watch

Za pierwszym razem agent buduje umiejętność od zera. Poproś o coś podobnego później, a użyje udoskonalonej wersji. Możesz to zobaczyć w praktyce, przeglądając katalog umiejętności po kilku sesjach.

Podłączenie do komunikatorów

Jedna z wyróżniających się cech Hermes Agent to wsparcie platform. Możesz z nim rozmawiać przez ponad 15 komunikatorów, a nie tylko przez CLI.

Konfiguracja Telegrama

Napisz do @BotFather na Telegramie, żeby stworzyć nowego bota
Skopiuj token bota
Dodaj go do konfiguracji:

hermes gateway add telegram --token "YOUR_BOT_TOKEN"

Uruchom bramkę:

hermes gateway start telegram

Teraz możesz rozmawiać ze swoim agentem bezpośrednio na Telegramie. Utrzymuje tę samą pamięć i umiejętności co sesje CLI.

Konfiguracja Discorda

Stwórz bota w Discord Developer Portal
Włącz Message Content Intent
Skopiuj token bota
Skonfiguruj:

hermes gateway add discord --token "YOUR_BOT_TOKEN"
hermes gateway start discord

Inne wspierane platformy

Ten sam schemat dotyczy wszystkich platform. Użyj hermes gateway add <platforma> z odpowiednimi poświadczeniami:

Slack: wymaga Slack App z uprawnieniami bota
WhatsApp: korzysta z WhatsApp Business API lub nieoficjalnego mostu
Signal: wymaga konfiguracji signal-cli
Matrix: potrzebuje konta bota Matrix
Mattermost: osobisty token dostępu
Email: poświadczenia IMAP/SMTP
SMS: Twilio lub podobny dostawca
DingTalk / Feishu / WeCom: dla chińskich komunikatorów

Uruchom hermes gateway list, żeby zobaczyć wszystkie dostępne platformy i ich status.

Wartościowe funkcje warte poznania

Hub umiejętności

Hermes Agent posiada repozytorium umiejętności społeczności. Przeglądaj i instaluj umiejętności stworzone przez innych:

# Przeglądaj dostępne umiejętności społeczności
hermes skills browse

# Zainstaluj konkretną umiejętność
hermes skills install web-scraper

# Lista zainstalowanych umiejętności
hermes skills list

Jest to przydatne, jeśli nie chcesz czekać, aż agent nauczy się od zera. Ktoś pewnie już stworzył umiejętność dla typowych zadań takich jak web scraping, testowanie API czy parsowanie dokumentów.

Harmonogramowanie cron

Konfiguruj powtarzalne zadania bez zewnętrznego cron:

hermes cron add "0 9 * * *" "Summarize yesterday's git commits and post to #dev-channel"

Agent zajmuje się harmonogramowaniem wewnętrznie i używa swoich umiejętności do wykonania zadania.

Tryb głosowy

Jeśli chcesz działać bez użycia rąk:

hermes chat --voice

Korzysta z mikrofonu i głośników twojego systemu. Działa najlepiej z modelami obsługującymi wejście audio, choć może też używać lokalnej warstwy speech-to-text.

Delegowanie do subagentów

Przy skomplikowanych wieloetapowych zadaniach Hermes Agent może uruchomić subagentów:

You: Research the top 5 VPS providers, compare their pricing, and create a summary document

Hermes: I'll delegate this to subagents for parallel research.
[spawns subagents for each provider]
[collects results]
[generates comparison document]

Subagenci współdzielą pamięć i system umiejętności rodzica, więc korzystają ze wszystkiego, czego główny agent się nauczył.

Rozwiązywanie problemów

„command not found: hermes"

Skrypt instalacyjny dodaje Hermes do twojego PATH, ale bieżąca powłoka mogła tego nie wychwycić. Rozwiązanie:

source ~/.bashrc  # lub ~/.zshrc

Jeśli to nie pomoże, sprawdź, czy istnieje ~/.local/bin/hermes i dodaj go do PATH ręcznie:

export PATH="$HOME/.local/bin:$PATH"

Błędy klucza API

Najpierw uruchom hermes doctor. Powie ci, czy twój klucz API jest nieprawidłowy, wygasł, czy wybrany model jest niedostępny. Typowe poprawki:

Dla OpenRouter: sprawdź swój klucz na openrouter.ai/keys
Darmowe modele czasami mają limity zapytań — spróbuj innej darmowej wersji
Upewnij się, że w kluczu API nie ma białych znaków na końcu

Model nie odpowiada

Modele na darmowym planie mają limity użycia. Jeśli na taki natrafisz:

hermes model list    # zobacz, co jest dostępne
hermes model set <inny-darmowy-model>  # przełącz się

Wysokie zużycie pamięci

Jeśli pamięć agenta urosła zbyt mocno (sprawdź przez du -sh ~/.hermes/memory/), możesz usunąć stare wpisy:

hermes memory prune --older-than 30d

To zachowa ostatnie interakcje i umiejętności, ale usunie logi konwersacji starsze niż 30 dni.

Problemy z połączeniem bramki

Dla komunikatorów upewnij się, że proces bramki działa:

hermes gateway status

Jeśli bramka ciągle się rozłącza, sprawdź sieć i zrestartuj ją:

hermes gateway restart telegram

Podsumowanie

Hermes Agent robi coś, czego nie widziałem u innych open-source'owych agentów: faktycznie uczy się twoich wzorców użycia i z czasem staje się lepszy, bez konieczności ręcznego definiowania przepływów pracy czy pisania własnych wtyczek. System umiejętności to prawdziwy wyróżnik — zadania, które za pierwszym razem zajmują 10 minut, za piątym zajmują 30 sekund.

To, że działa na tanim sprzęcie i łączy się z darmowymi dostawcami modeli, oznacza, że możesz mieć osobistego agenta AI działającego 24/7 niemal za darmo. Podłącz go do Telegrama lub Discorda i masz stale dostępnego asystenta, który pamięta twoje preferencje, twoją bazę kodu i twoje przepływy pracy.

Żeby zacząć:

Wybierz VPS (albo użyj lokalnego komputera) — LightNode sprawdza się tu świetnie
Uruchom instalator jedną komendą
Zarejestruj się na OpenRouter i wybierz darmowy model
Zacznij rozmawiać

Repozytorium na GitHubie ma szczegółową dokumentację, a społeczność jest aktywna, jeśli napotkasz problemy. Poświęć mu weekend — do poniedziałku będziesz miał agenta, który już zaczął budować umiejętności dopasowane do twojej pracy.