Instalacja Hermes i konfiguracja OmniProxy

Hermes to asystent, który zachowuje rozmowy i doświadczenia z realizowanych zadań. Wykonane czynności można przekształcić w umiejętności do późniejszego wykorzystania. Za pośrednictwem jednej bramy Gateway może również łączyć się z Telegramem, Discordem, Slackiem, WhatsAppem, Signalem i terminalem. Gateway to wspólny punkt odbierania i przekazywania wiadomości. Z poziomu używanego na co dzień komunikatora możesz zlecić mu przegląd kodu, sporządzenie dokumentacji incydentu lub opracowanie materiałów klienta, a następnie polecić kontynuowanie pracy w repozytorium.

Przygotowanie do instalacji

Najpierw wybierz metodę instalacji odpowiednią dla systemu operacyjnego komputera. W systemach macOS i Windows możesz bezpośrednio użyć instalatora z interfejsem graficznym. W systemach Linux, macOS i WSL2 możesz użyć skryptu uruchamianego w terminalu. WSL2 to funkcja umożliwiająca uruchamianie środowiska Linux w systemie Windows. Osobne metody instalacji są także dostępne dla aplikacji Termux na urządzeniach z Androidem oraz dla Dockera, ale ten przewodnik obejmuje wyłącznie instalację na zwykłym komputerze.

Chcesz okno

macOS、Windows

• macOS: otwórz DMG
• Windows: otwórz pakiet instalacyjny
• Przenieś aplikację do systemu

Tylko terminal

Linux、macOS、WSL2

• Jeden install.sh
• W Windows użyj install.ps1
• Po instalacji wpisz hermes

Na razie nie używaj

pip、brew、AUR

• Oficjalnie nie są obsługiwane te metody instalacji
• Późniejsza aktualizacja jest trudna
• Użyj dwóch metod po lewej

Przed rozpoczęciem przygotuj komputer z systemem macOS, Windows lub Linux i upewnij się, że można na nim otworzyć terminal oraz uzyskać dostęp do GitHub. Jeśli planujesz instalację na dysku zewnętrznym, najpierw podłącz dysk i sprawdź, czy jest na nim wystarczająco dużo wolnego miejsca.

Instalacja i pierwsze uruchomienie

Instalacja z interfejsem graficznym

Przejdź do sekcji pobierania w witrynie Hermes i pobierz instalator przeznaczony dla swojego systemu. Instalator zawiera już środowisko uruchomieniowe, dlatego przy pierwszym uruchomieniu nie trzeba niczego kompilować na komputerze.

• macOS: otwórz plik DMG i przenieś Hermes.app do folderu „Aplikacje”. DMG to format obrazu instalacyjnego powszechnie używany w macOS. Ten instalator obsługuje wyłącznie komputery z procesorem Apple. Komputery Mac z procesorem Intel nie są obsługiwane.
• Windows: otwórz plik .appinstaller za pomocą Instalatora aplikacji systemu Windows. Zainstalowany zostanie podpisany pakiet MSIX, czyli jeden z formatów pakietów instalacyjnych używanych przez Windows.
• Linux: instalator desktopowy jest przeznaczony dla systemów macOS i Windows. W systemie Linux użyj poniższego polecenia terminalowego. Po instalacji możesz uruchomić hermes desktop.

Instalacja tylko przez terminal

Jeśli używasz systemu Linux, macOS lub WSL2, wykonaj w terminalu:

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

Jeśli używasz programu PowerShell dołączonego do systemu Windows, wykonaj:

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

Instalator pobierze kod Hermes oraz programy wymagane do jego działania. Jeśli pobieranie zostanie przerwane, ponownie wykonaj to samo polecenie. Po zakończeniu instalacji zamknij bieżący terminal, otwórz nowe okno i wpisz:

hermes

Wyświetlenie monitu Hermes oznacza, że polecenie jest już dostępne. Następnie możesz uruchomić hermes doctor. To narzędzie kontrolne instalacji, które wskaże ewentualne brakujące elementy.

Program na dysku zewnętrznym

9 października 2026 r. Hermes Agent v0.21.6 został zainstalowany na dysku zewnętrznym podłączonym do komputera Mac. Program znajdował się w /Volumes/AItools/tools/hermes-agent, polecenie uruchamiające w ~/.local/bin/hermes, a konfiguracja i rozmowy nadal były zapisywane w ~/.hermes.

Jeśli Twój dysk ma inną nazwę, zmień ścieżkę po --dir na ścieżkę do własnego folderu. Podczas działania Hermes dysk musi pozostać podłączony.

curl -fsSL https://hermes-agent.nousresearch.com/install.sh -o install.sh
bash install.sh --dir /Volumes/AItools/tools/hermes-agent --non-interactive

Program

Dysk przenośny

• tools/hermes-agent
• Umieść kod tutaj

Polecenie

~/.local/bin/hermes

• Wpisz hermes w terminalu
• Zacznie działać po otwarciu nowego okna

Konfiguracja i rozmowy

~/.hermes

• Tutaj znajduje się config.yaml
• Przed odłączeniem dysku najpierw zakończ pracę

Pobieranie parametrów połączenia z OmniProxy

Hermes łączy się tutaj z OmniProxy, a nie bezpośrednio z Grok lub Gemini. Adresy usług Grok i Gemini konfiguruje się w OmniProxy. Nie wpisuj ich bezpośrednio w Hermes.

Twój komputer

Hermes

→

Lokalna brama

OmniProxy

• Adres zakończ na /v1

→

Grok

• grok-4.7

Gemini

• gemini-3.8-flash

Identyfikator modelu, czyli Model ID, to dokładna nazwa używana przez interfejs do rozpoznawania modelu. Dla obu modeli użyj następujących nazw:

• W przypadku Grok wpisz grok-4.7. Adres interfejsu xAI to https://api.x.ai/v1, a żądania czatu są wysyłane do /v1/chat/completions. Zobacz dokumentację modeli Grok.
• W przypadku Gemini wpisz gemini-3.8-flash. Adres interfejsu Google zgodnego z OpenAI to https://generativelanguage.googleapis.com/v1beta/openai/. Zobacz opis zgodności Gemini z OpenAI.

Aby przełączyć Hermes na Gemini, wystarczy zmienić nazwę modelu na gemini-3.8-flash. Jako adres interfejsu nadal należy podać adres OmniProxy.

Skopiuj adres interfejsu i klucz z OmniProxy, a następnie wpisz właściwy identyfikator modelu:

Base URL: https://your-omniproxy-origin.example/v1
API Key:  <YOUR_OMNIPROXY_API_KEY>
Model ID: grok-4.7

Base URL to adres interfejsu, do którego Hermes wysyła żądania. W tym przypadku musi kończyć się ciągiem /v1. API Key to klucz przekazany Hermes przez OmniProxy. Zastąp go własną wartością i nie publikuj go na ogólnodostępnych stronach.

Jeśli lokalna instancja OmniProxy nie wymaga klucza, pole API Key może pozostać puste. Jeżeli adres jest dostępny dla innych osób, należy ustawić klucz. Upewnij się również, że ten adres jest dostępny ze środowiska, w którym działa Hermes. Jeśli Hermes i OmniProxy działają na tym samym komputerze, możesz użyć adresu lokalnego.

Wprowadzanie konfiguracji narzędzia

Najpierw zakończ trwającą rozmowę, a następnie wykonaj w terminalu:

hermes model

Wybierz Custom endpoint (self-hosted / VLLM / etc.). Custom endpoint oznacza niestandardowy interfejs, dzięki któremu Hermes łączy się ze wskazanym przez Ciebie adresem usługi zamiast ze wstępnie skonfigurowanym dostawcą.

Kreator kolejno zapyta o adres interfejsu, klucz i nazwę modelu. Wpisz trzy wartości z poprzedniej sekcji. Jeśli chcesz używać Gemini, jako nazwę modelu wpisz gemini-3.8-flash.

Możesz też bezpośrednio edytować plik ~/.hermes/config.yaml. YAML to tekstowy format konfiguracji, w którym zależności są określane za pomocą wcięć. Poniżej znajduje się konfiguracja dla Grok:

model:
  default: grok-4.7
  provider: custom
  base_url: https://your-omniproxy-origin.example/v1
  api_key: <YOUR_OMNIPROXY_API_KEY>

W przypadku Gemini zmień wartość default na gemini-3.8-flash. Pozostałe trzy wartości pozostają bez zmian:

model:
  default: gemini-3.8-flash
  provider: custom
  base_url: https://your-omniproxy-origin.example/v1
  api_key: <YOUR_OMNIPROXY_API_KEY>

Po zapisaniu ponownie uruchom hermes, a następnie rozpocznij rozmowę. W już otwartej sesji polecenie /model pozwala tylko przełączać się między wcześniej zapisanymi dostawcami. Nie można za jego pomocą dodać tej konfiguracji.

Weryfikacja na rzeczywistym zadaniu

1

hermes doctor

• Kontrola instalacji zakończona pomyślnie

2

Wyślij krótką wiadomość

• Zobacz odpowiedź Hermes

3

Otwórz rejestr wywołań

• Sprawdź nazwę modelu

1. Uruchom hermes doctor, aby sprawdzić kompletność instalacji.
2. Uruchom hermes i poproś go, aby w jednym zdaniu opisał, co potrafi zrobić. Powinna pojawić się odpowiedź.
3. Otwórz historię wywołań OmniProxy, sprawdź, czy żądanie pochodzi z Hermes, i upewnij się, że nazwa modelu to grok-4.7 lub gemini-3.8-flash.

Samo potwierdzenie zapisania ustawień przez kreator lub zwrócenie powodzenia przez interfejs nie oznacza jeszcze, że Hermes może wykonywać zadania. Nazwa modelu w historii wywołań musi być identyczna z wprowadzoną wartością.

Aby rozmawiać w przeglądarce, wykonaj lokalnie:

hermes dashboard --no-open --host 127.0.0.1 --port 9119

Następnie otwórz http://127.0.0.1:9119. Ten adres działa wyłącznie na bieżącym komputerze.

Typowe błędy

• Po wpisaniu hermes pojawia się informacja, że nie znaleziono polecenia: zamknij terminal i otwórz nowe okno. Jeśli polecenie nadal nie jest dostępne, sprawdź, czy ~/.local/bin znajduje się w PATH. PATH to lista lokalizacji, w których system szuka poleceń. W systemie Windows sprawdź, czy katalog uruchamiania dodany przez instalator znajduje się w PATH.
• Pobieranie instalacji zostało przerwane: ponownie wykonaj to samo polecenie instalacyjne. Pobrane wcześniej elementy zostaną ponownie wykorzystane.
• Hermes nie odpowiada lub zgłasza brak połączenia: sprawdź, czy OmniProxy jest uruchomiony, oraz upewnij się, że Base URL kończy się ciągiem /v1. Jeśli Hermes działa w Dockerze, a OmniProxy na hoście, nie używaj adresu 127.0.0.1, który jest dostępny wyłącznie wewnątrz kontenera.
• Pojawia się błąd klucza: zaktualizuj klucz OmniProxy, a następnie zmień api_key w pliku config.yaml. Klucze xAI lub Google należą do ustawień dostawców w OmniProxy. Nie wpisuj ich w tym polu konfiguracji Hermes.
• Pojawia się informacja, że model nie istnieje: otwórz aktualną listę modeli w OmniProxy i skopiuj grok-4.7 lub gemini-3.8-flash dokładnie w takiej postaci, w jakiej widnieje na liście.
• Hermes odpowiada, ale nie może wykonywać takich czynności jak odczytywanie plików lub uruchamianie poleceń: wybierz w OmniProxy inny model obsługujący te możliwości, a następnie uruchom nową sesję Hermes.
• Program znajduje się na dysku zewnętrznym, a po odłączeniu dysku hermes doctor zgłasza błąd pamięci masowej: najpierw ponownie podłącz ten dysk. Nie pozwalaj Hermes tworzyć osobnej konfiguracji, gdy dysk nie jest podłączony.

Materiały referencyjne

Instrukcje instalacji znajdziesz w dokumentacji instalacji Hermes oraz w opisie obsługiwanych platform. Konfigurację Custom endpoint opisano w dokumentacji dostawców Hermes. Identyfikatory modeli można sprawdzić odpowiednio w dokumentacji modeli Grok oraz w opisie zgodności Gemini z OpenAI.

Instalację w systemie macOS przeprowadzono 2026-10-09 przy użyciu Hermes Agent v0.21.6. grok-4.7 i gemini-3.8-flash były tego dnia standardowymi identyfikatorami modeli w dokumentacji xAI i Google. Podczas konfiguracji kieruj się nazwami wyświetlanymi w OmniProxy.

Zastąp każdy placeholder wartościami z własnej konfiguracji OmniProxy. Nigdy nie publikuj prawdziwego klucza.

Zapisany wynik lub HTTP 200 samo w sobie nie dowodzi pełnej kompatybilności Agenta. Sprawdź źródło i model w rejestrze połączeń OmniProxy.

Źródła oficjalne · Hermes ↗