Wiki · Začínáme
Instalace na VPS
Od prázdného serveru k běžícímu agentovi — česky, s reáliemi u nás a s pastmi, na které jsme sami narazili.
Proč vlastní server
Agent umí běžet i na vašem počítači, ale svoje schopnosti ukáže až ve chvíli, kdy pracuje pořád — sbírá data v noci, posílá vám zprávu ráno a má u sebe svoje nástroje a poznámky, i když je váš notebook vypnutý. Proto se vyplatí malý server (VPS).
Dobrá zpráva: stačí úplně obyčejný server za pár desítek korun měsíčně. Žádná grafická karta, žádný velký výkon — agent hlavně komunikuje s modelem přes internet.
Co budete potřebovat
| Co | Stačí | Poznámka |
|---|---|---|
| Server (VPS) | 1–2 jádra, 2 GB paměti, 20 GB disku | Linux, ideálně Ubuntu 24.04 |
| Přístup | IP adresa a heslo nebo SSH klíč | Dostanete e-mailem po objednání |
| Systém | Ubuntu, Debian, Fedora, openSUSE, Alpine… | Zvládne i Raspberry Pi |
| Přihlášení k modelu | Účet u poskytovatele modelu | Vyřešíme v kroku 4 |
Kde server pořídit: v Česku třeba Wedos, vpsFree nebo Active24 (platba převodem i kartou), ze zahraničí Contabo nebo Hetzner (platba kartou, vyjde levněji). Ceny se mění, proto si je před objednáním ověřte — na výběr se díváme v návodu Hosting pro AI agenta. Hledejte v nabídce „VPS" nebo „Cloud", ne „webhosting" — agent potřebuje vlastní systém, kde si sám instaluje, co potřebuje.
1. Objednejte server
V nabídce zvolte Ubuntu 24.04 LTS (nejlépe prověřená varianta), nejmenší tarif a pokud to jde, přidejte SSH klíč — bezpečnější než heslo. Po objednání vám přijde IP adresa, přihlašovací jméno a heslo.
2. Přihlaste se a připravte systém
Napište první příkaz — místo IP adresy dejte tu, kterou jste dostali e-mailem — a potvrďte Enterem:
Příkaz se v ukázce vypíše sám a pod ním uvidíte, co server opravdu odpoví: uvítací zprávu a čekající kurzor. Server sám nic nespustí, jen čeká na další příkaz — kliknutím na okno si ukázku přehrajete znovu.
Teď napište druhý příkaz (opět ho vložte a potvrďte Enterem) — systém se aktualizuje:
Pak si vytvořte vlastního uživatele a pracujte pod ním, ne jako root:
Proč ne jako root? Agent si v domovské složce drží konfiguraci, klíče a poznámky. Když ho spustíte jako root, všechno skončí ve složce roota — a s právy roota běží i případné chyby. Oficiální dokumentace to výslovně nedoporučuje.
3. Nainstalujte agenta
Instalaci spustíte jediným příkazem — vložte ho do terminálu a potvrďte Enterem. Instalátor si sám stáhne zdrojový kód a přinese i potřebné součásti (Python, Node, ripgrep, FFmpeg), takže na minimálním serveru není co doinstalovávat:
Trvá to zhruba minutu. Na konci je potřeba znovu načíst prostředí shellu — jinak systém příkaz „hermes" ještě nezná. To je nejčastější chyba začátečníků a zároveň nejjednodušší oprava:
Volitelně je dobré spustit kontrolu prostředí, která poradí, co ještě chybí:
4. Vyberte model a přihlaste se
Agent potřebuje model — mozek, který přemýšlí. Dvě rozumné cesty:
U varianty B si klíč vezměte u poskytovatele modelu (např. Nous Research, OpenAI, Anthropic, Google, OpenRouter) a vložte ho do schvalovacího formuláře, který se sám otevře. Vyberte model s kontextem aspoň 64 tisíc tokenů — menší Hermes odmítne spustit, protože by nezvládl svoje nástroje a paměť.
Nevíte, který poskytovatel se dá zaplatit z Česka a kolik to vyjde? Připravujeme stránku Výběr modelu a platba z Česka — zatím se ptejte v naší komunitě na Discordu.
5. První rozhovor
Napište jen hermes — otevře se rozhovor v terminálu. Zadávejte agentovi úkoly, u kterých si snadno ověříte výsledek:
Zkuste třeba: „Podívej se, kolik místa zabírá disk, a napiš mi to do tabulky." nebo „Najdi na serveru všechny soubory větší než 100 MB." Uvidíte, jak si agent sám spouští příkazy a hlásí výsledek.
6. Aby pracoval dál, když zavřete okno
Poslední krok je udělat z agenta službu, která se po restartu serveru zvedne sama. Slouží k tomu gateway — rozhraní, přes které agent přijímá zprávy (Discord, Telegram, e-mail) a běží na pozadí:
Pokud nemáte práva roota, ať se služba spustí i po odhlášení, povolte takzvaný linger: sudo loginctl enable-linger $USER.
Na co jsme narazili (a co v dokumentaci nenajdete)
| Situace | Řešení |
|---|---|
hermes: command not found po instalaci | Není načtené prostředí shellu — napište source ~/.bashrc (nebo se odhlaste a znovu přihlaste) |
Instalace hlásí chybějící knihovnu libatomic1 | Vyskytuje se u nejmenších Debian/Ubuntu obrazů; instalátor si sám vyžádá sudo — potvrďte ho |
| Agent se odmítá spustit kvůli modelu | Zvolený model má méně než 64 tisíc tokenů kontextu. Vyberte jiný (hermes model) |
| Po aktualizaci agenta se změnila konfigurace | hermes config check (co je nové) a hermes config migrate (převede staré hodnoty) |
| Chci agenta přesunout na jiný server | hermes backup na starém, hermes import na novém — přenese i klíče a paměť |
| Něco se rozbilo | Nikdy nemažte datovou složku ~/.hermes/ „kvůli opravě" — přijdete o klíče i poznámky. Opravuje se instalace, ne data |
