Przewodnik instalacji

Uruchom Hermesa

Hermes Agent v0.8.0 instaluje się w około 60 sekund na Linuxie, macOS-ie lub WSL2. Jedna komenda curl, a instalator zajmie się uv, Pythonem 3.11, Node.js, ripgrepem i ffmpegiem.

checklist Wymagania systemowe

javascript Node.js

Jedynym wymaganiem jest git — Python 3.11, Node.js v22, uv, ripgrep i ffmpeg są instalowane przez skrypt

computer OS

Linux, macOS, WSL2 na Windowsie lub Android przez Termux. Natywny Windows nie jest obsługiwany.

memory RAM

Minimum 2 GB RAM; więcej, jeśli uruchamiasz lokalne modele

hard_drive Disk

~1 GB na agenta, jego venv, moduły Node i wbudowane umiejętności

extension Optional

Opcjonalnie: Docker, SSH, Daytona, Singularity lub Modal do izolowanego wykonywania komend

wifi Network

Wymagane połączenie z internetem dla API modeli w chmurze. Lokalne modele przez endpoint kompatybilny z OpenAI działają offline.

Jednolinijkowiec z oficjalnej dokumentacji. Zalecany dla większości użytkowników na Linuxie, macOS-ie lub WSL2. Dokumentacja instalacji arrow_forward

WSL2 (Windows)

Natywny Windows nie jest obsługiwany. Uruchom to w powłoce WSL2 po 'wsl --install'.

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

macOS / Linux / WSL2

Jedynym wymaganiem jest git — instalator sam zajmie się uv, Pythonem 3.11, Node.js v22, ripgrepem i ffmpegiem.

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

verified Zweryfikuj instalację

Uruchom komendy weryfikacyjne wymienione w oficjalnej dokumentacji.

1
$ hermes version

Wyświetla zainstalowaną wersję (powinno być 0.8.0 lub nowsze).

2
$ hermes doctor

Uruchamia diagnostykę — Python, uv, zależności, pliki konfiguracyjne i łączność.

3
$ hermes status

Wyświetla bieżącą konfigurację: dostawca modeli, włączone narzędzia i podłączone bramy.

settings Konfiguracja początkowa

Po instalacji przeładuj powłokę, a następnie uruchom trzy komendy konfiguracyjne z dokumentacji.

1

Wybierz dostawcę modeli

Uruchom 'hermes model', aby wybrać dostawcę. README wymienia Nous Portal, OpenRouter, z.ai/GLM, Kimi/Moonshot, MiniMax, OpenAI i niestandardowe endpointy. Anthropic i Mistral też są dołączone jako zależności.

2

Włącz narzędzia

Uruchom 'hermes tools', aby skonfigurować, które z 47 wbudowanych narzędzi są włączone. Możesz je dodawać lub usuwać później.

3

Uruchom pełnego kreatora

Uruchom 'hermes setup', aby przejść przez kompletnego kreatora, w tym klucze API i połączenia bram czatowych (Telegram, Discord, Slack, WhatsApp, Signal, e-mail).

4

Wyślij wiadomość testową

Spróbuj 'hermes chat -q "Cześć! Jakie narzędzia masz dostępne?"' — prosto z oficjalnego quickstartu.

.env — Konfiguracja jest w ~/.hermes/ — config.yaml dla głównych ustawień, .env dla kluczy API, plus podkatalogi na sesje, logi, pamięć, umiejętności i zadania cron. Zobacz referencję zmiennych środowiskowych na hermes-agent.nousresearch.com/docs/reference/environment-variables.

cloud Wdrożenie na VPS / serwerze

Hermes działa na dowolnym VPS-ie z Linuxem z 2 GB RAM i ~1 GB dysku. Ten sam jednolinijkowiec działa przez SSH.

1

Połącz się z serwerem przez SSH

Działa na dowolnej dystrybucji Linuxa — Ubuntu, Debian, CentOS, Arch itp.

$ ssh user@twoj-adres-ip-serwera
2

Uruchom instalator

Skrypt automatycznie wykrywa dystrybucję, instaluje Pythona 3.11 przez uv i konfiguruje wszystkie zależności.

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

Włącz backend sandbox

Na współdzielonej infrastrukturze skonfiguruj jeden z backendów sandbox (Docker, SSH, Daytona, Singularity lub Modal), aby komendy powłoki Hermesa działały w izolacji. Szczegóły konfiguracji w README.

4

Ustaw klucz API i uruchom

Wybierz dostawcę modeli i uruchom Hermesa. Użyj tmux lub screen do trwałości — proces działa na pierwszym planie.

$ hermes model && hermes

Tip — Aby uruchomić jako daemon, odpal Hermesa w tmux/screen lub napisz plik usługi systemd. Sprawdź oficjalną dokumentację po konfigurację daemona.

system_update_alt Aktualizacja Hermesa

README dokumentuje wbudowany updater: 'hermes update'. Nie ma opublikowanego pakietu PyPI ani obrazu Docker, więc inne ścieżki aktualizacji prowadzą przez git. Przewodnik aktualizacji arrow_forward

npm
$ hermes update
pnpm
$ cd ~/.hermes/hermes-agent && git pull && uv pip install -e ".[all]"
Git
$ curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
Docker
$ # Brak oficjalnie opublikowanego obrazu Docker

Sprawdź github.com/NousResearch/hermes-agent/releases po zmiany w każdej wersji.

delete_forever Odinstalowywanie Hermesa

Hermes instaluje się w ~/.hermes/hermes-agent/ i tworzy symlink binarium do ~/.local/bin/hermes. Usunięcie obu wymaga dwóch komend. Uwagi o odinstalowaniu arrow_forward

npm
$ rm ~/.local/bin/hermes
pnpm
$ rm -rf ~/.hermes/hermes-agent
Git (Source)
$ rm -rf ~/.hermes/hermes-agent
Docker
$ # Brak oficjalnego obrazu Docker do usunięcia

Usuń dane użytkownika (opcjonalnie)

To usuwa sesje, wspomnienia, umiejętności, zadania cron i klucze API. Zrób kopię zapasową wszystkiego, co potrzebujesz.

macOS/Linux $ rm -rf ~/.hermes
Windows PS> # Uruchom w powłoce WSL — natywny Windows nie jest obsługiwany

build Rozwiązywanie problemów

Na podstawie tabeli rozwiązywania problemów z dokumentacji instalacji i typowych błędów skryptu. Więcej wskazówek arrow_forward

Potrzebujesz pomocy?

Dołącz do Discorda Nous Research po wsparcie przy instalacji i pomoc społeczności.

Bądź na bieżąco

Aktualności społeczności o wydaniach Hermes Agent, nowych umiejętnościach i integracjach. Bez spamu, wypisz się kiedy chcesz.