Instalace Hermes a konfigurace OmniProxy

Hermes je asistent, který dokáže uchovávat konverzace a zkušenosti z úkolů a měnit dokončenou práci na dovednosti, které lze později znovu použít. Prostřednictvím jediné brány se také může připojit k Telegramu, Discordu, Slacku, WhatsAppu, Signalu a terminálu. Brána slouží jako jednotný vstupní bod pro přijímání a předávání zpráv. Můžete jí posílat recenze kódu, poznámky k incidentům nebo zákaznické materiály ze svých obvyklých chatovacích nástrojů a poté ji nechat vrátit se do repozitáře a pokračovat v práci.

Než začnete

Nejprve zvolte metodu instalace na základě operačního systému vašeho počítače. macOS a Windows mohou přímo používat grafické instalátory, zatímco Linux, macOS a WSL2 mohou používat terminálový skript. WSL2 je funkce Windows pro spuštění prostředí Linuxu. Termux na telefonech Android a Docker mají své vlastní metody instalace, ale tato příručka pokrývá pouze instalaci na běžné počítače.

Chcete okno

macOS, Windows

• macOS: otevřete DMG
• Windows: otevřete instalátor
• Nainstalujte aplikaci do systému

Pouze terminál

Linux, macOS, WSL2

• Jeden příkaz install.sh
• Použijte install.ps1 na Windows
• Po instalaci zadejte hermes

Zatím nepoužívejte tyto

pip, brew, AUR

• Tyto metody instalace nejsou oficiálně podporovány
• Jsou také obtížně aktualizovatelné po instalaci
• Místo toho použijte jednu ze dvou možností vlevo

Než začnete, připravte si počítač s macOS, Windows nebo Linuxem a ujistěte se, že může otevřít terminál a přistupovat ke GitHubu. Pokud plánujete nainstalovat Hermes na externí disk, nejprve disk připojte a potvrďte, že má dostatek volného místa.

Instalace a první spuštění

Pokud chcete grafickou aplikaci

Přejděte do sekce stahování na webu Hermes a stáhněte si instalátor pro váš operační systém. Instalátor již obsahuje běhové prostředí, takže při prvním otevření není třeba nic lokálně kompilovat.

• macOS: Otevřete DMG a přesuňte Hermes.app do Aplikací. DMG je instalační obraz běžně používaný na macOS. Tento instalátor podporuje pouze Apple silicon; Intel Macy nejsou podporovány.
• Windows: Otevřete soubor .appinstaller pomocí Windows App Installer. Nainstaluje podepsaný MSIX, typ balíčku aplikací používaný Windows.
• Linux: Desktopové instalátory jsou pro macOS a Windows. Na Linuxu použijte níže uvedený příkaz terminálu. Po instalaci můžete spustit hermes desktop.

Pokud potřebujete pouze terminál

Pokud používáte Linux, macOS nebo WSL2, spusťte v terminálu:

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

Při použití PowerShellu, který je součástí Windows, spusťte:

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

Instalátor stáhne kód Hermes a programy potřebné k jeho spuštění. Pokud je stahování přerušeno, spusťte stejný příkaz znovu. Po dokončení instalace zavřete aktuální terminál, otevřete nové okno a zadejte:

hermes

Pokud vidíte výzvu Hermes, příkaz je připraven k použití. Poté můžete spustit hermes doctor; tato kontrola instalace vám řekne, co stále chybí.

Uložení programu na externí disk

9. října 2026 byl Hermes Agent v0.21.6 nainstalován na externí disk připojený k Macu. Program byl uložen v /Volumes/AItools/tools/hermes-agent, příkaz spouštěče se nacházel v ~/.local/bin/hermes, a konfigurační a konverzační data zůstala v ~/.hermes.

Pokud má váš disk jiný název, nahraďte cestu za --dir vlastní složkou. Disk musí zůstat připojen, zatímco Hermes běží.

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

Program

Externí disk

• tools/hermes-agent
• Kód uchovávejte zde

Příkaz

~/.local/bin/hermes

• Zadejte hermes v terminálu
• Projeví se po otevření nového okna

Konfigurace a chaty

~/.hermes

• config.yaml je zde
• Před odpojením disku ukončete

Získání hodnot připojení z OmniProxy

Zde se Hermes připojuje k OmniProxy namísto přímého připojení ke Grok nebo Gemini. Nakonfigurujte adresy URL služeb Grok a Gemini v OmniProxy; nezadávejte je přímo v Hermes.

Váš počítač

Hermes

→

Místní brána

OmniProxy

• Zahrňte /v1 do adresy

→

Grok

• grok-4.7

Gemini

• gemini-3.8-flash

ID modelu je přesný název, který API používá k identifikaci modelu. Pro tyto dva modely použijte následující názvy:

• Pro Grok zadejte grok-4.7. API xAI je https://api.x.ai/v1, a požadavky chatu používají /v1/chat/completions. Viz dokumentace modelu Grok.
• Pro Gemini zadejte gemini-3.8-flash. API Google kompatibilní s OpenAI je https://generativelanguage.googleapis.com/v1beta/openai/. Viz dokumentace kompatibility Gemini s OpenAI.

Chcete-li přepnout Hermes na Gemini, změňte pouze název modelu na gemini-3.8-flash. Pokračujte v používání adresy OmniProxy jako koncového bodu API.

Zkopírujte adresu URL koncového bodu a klíč z OmniProxy a poté zadejte odpovídající ID modelu:

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

Base URL je koncový bod, na který Hermes odesílá požadavky. Musí zde končit /v1 . API Key je klíč, který OmniProxy vydává pro Hermes. Nahraďte zástupný symbol vlastní hodnotou a nezveřejňujte jej na veřejné stránce.

Pokud vaše místní instance OmniProxy nevyžaduje klíč, můžete API Key nechat prázdný. Pokud je adresa přístupná komukoli jinému, měli byste použít klíč. Také potvrďte, že adresa je dosažitelná z prostředí, kde Hermes běží. Pokud jsou Hermes a OmniProxy ve stejném počítači, můžete použít místní adresu.

Zadání konfigurace nástroje

Nejprve ukončete aktuální chat a poté v terminálu spusťte:

hermes model

Vyberte Custom endpoint (self-hosted / VLLM / etc.). Custom endpoint znamená, že se Hermes připojuje k adrese služby, kterou určíte, namísto použití přednastaveného poskytovatele.

Průvodce nastavením postupně požádá o adresu URL koncového bodu, klíč a název modelu. Zadejte tři hodnoty z předchozí části. Chcete-li použít Gemini, zadejte gemini-3.8-flash jako název modelu.

Můžete také upravit ~/.hermes/config.yaml přímo. YAML je textový formát, který používá odsazení k reprezentaci konfiguračních vztahů. Následující konfigurace používá Grok:

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

Chcete-li použít Gemini, změňte default na gemini-3.8-flash a ponechte ostatní tři hodnoty beze změny:

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

Po uložení spusťte hermes znovu a zahajte nový chat. V již otevřené relaci, /model může přepínat pouze mezi poskytovateli, kteří již byli uloženi; nemůže přidat tuto konfiguraci.

Ověření pomocí skutečného úkolu

1

hermes doctor

• Kontrola instalace prošla

2

Pošlete krátkou zprávu

• Uvidíte odpověď od Hermes

3

Otevřete protokoly požadavků

• Ověřte název modelu

1. Spusťte hermes doctor pro kontrolu, zda je instalace dokončena.
2. Spusťte hermes a požádejte jej, aby jednou větou vysvětlil, co dokáže. Měli byste vidět odpověď.
3. Otevřete protokol požadavků OmniProxy, potvrďte, že požadavek přišel z Hermes, a zkontrolujte, zda je název modelu grok-4.7 nebo gemini-3.8-flash.

Vidět, že se průvodce nastavením úspěšně uložil, nebo že API vrátilo úspěšnou odpověď, nestačí k tomu, aby Hermes mohl plnit úkoly za vás. Název modelu v protokolu požadavků se musí shodovat s hodnotou, kterou jste zadali.

Chcete-li chatovat v prohlížeči, spusťte lokálně následující:

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

Poté otevřete http://127.0.0.1:9119. Tato adresa funguje pouze v aktuálním počítači.

Běžné chyby

• Zadání hermes ohlásí, že příkaz nelze nalézt: Zavřete terminál a otevřete nové okno. Pokud příkaz stále není nalezen, potvrďte, že ~/.local/bin je v PATH. PATH je seznam adresářů, kde systém hledá příkazy. Ve Windows potvrďte, že spouštěcí adresář přidaný instalátorem je v PATH.
• Stahování instalace se v polovině zastaví: Spusťte stejný instalační příkaz znovu. Již stažené části budou znovu použity.
• Hermes neodpovídá nebo hlásí, že se nemůže připojit: Potvrďte, že OmniProxy běží, a zkontrolujte, zda Base URL končí na /v1. Pokud Hermes běží v Dockeru, zatímco OmniProxy běží na hostiteli, nepoužívejte 127.0.0.1 pokud je platná pouze uvnitř kontejneru.
• Objeví se chyba klíče: Aktualizujte klíč OmniProxy, poté změňte api_key v config.yaml. Klíč xAI nebo Google patří do nastavení poskytovatele OmniProxy; nezadávejte jej do tohoto pole Hermes.
• Model je hlášen jako nedostupný: Otevřete aktuální seznam modelů v OmniProxy a zkopírujte grok-4.7 nebo gemini-3.8-flash přesně tak, jak se objevuje v seznamu.
• Hermes odpovídá, ale nemůže provádět úkoly, jako je čtení souborů nebo provádění příkazů: Přepněte na jiný model v OmniProxy, který tyto schopnosti má, a poté zahajte novou relaci Hermes.
• Program je na externím disku a hermes doctor hlásí chybu úložiště po odpojení disku: Nejprve disk znovu připojte. Nenechte Hermes vytvořit samostatnou konfiguraci, zatímco je disk odpojen.

Reference

Pro kroky instalace viz dokumentace instalace Hermes a podpora platforem. Pro konfiguraci Custom endpoint viz dokumentace poskytovatele Hermes. Pro ID modelů viz dokumentace modelu Grok a dokumentace kompatibility Gemini s OpenAI.

Proces instalace na macOS byl dokončen 9. 10. 2026 pomocí Hermes Agent v0.21.6. grok-4.7 a gemini-3.8-flash byla standardní ID modelů v dokumentaci xAI a Google k tomuto datu. Při zadávání hodnot použijte názvy zobrazené v OmniProxy.

Nahraďte všechna záložní místa hodnotami z vlastní konfigurace OmniProxy. Nikdy nezveřejňujte skutečný klíč.

Uložený výsledek nebo HTTP 200 samo o sobě nedokazuje plnou kompatibilitu agenta. Zkontrolujte zdroj a model v záznamu požadavku OmniProxy.

Oficiální zdroje · Hermes ↗