Inštalácia Hermes a konfigurácia OmniProxy

Hermes je asistent, ktorý dokáže uchovávať konverzácie a skúsenosti z úloh, čím mení dokončenú prácu na zručnosti, ktoré možno neskôr znova použiť. Prostredníctvom jednej brány sa môže pripojiť aj k Telegramu, Discordu, Slacku, WhatsAppu, Signalu a terminálu. Brána slúži ako jednotný vstupný bod na prijímanie a preposielanie správ. Môžete mu posielať recenzie kódu, poznámky k incidentom alebo zákaznícke materiály z vašich bežných nástrojov chatu a potom ho nechať vrátiť sa do repozitára a pokračovať v práci.

Skôr než začnete

Najprv vyberte spôsob inštalácie na základe operačného systému vášho počítača. macOS a Windows môžu priamo používať grafické inštalátory, zatiaľ čo Linux, macOS a WSL2 môžu používať terminálový skript. WSL2 je funkcia systému Windows na spustenie prostredia Linux. Termux na telefónoch s Androidom a Docker majú svoje vlastné spôsoby inštalácie, ale táto príručka pokrýva iba inštaláciu na bežných počítačoch.

Chcete okno

macOS, Windows

• macOS: otvorte DMG
• Windows: otvorte inštalátor
• Nainštalujte aplikáciu do systému

Iba terminál

Linux, macOS, WSL2

• Jeden príkaz install.sh
• Použite install.ps1 vo Windows
• Po inštalácii zadajte hermes

Zatiaľ ich nepoužívajte

pip, brew, AUR

• Tieto spôsoby inštalácie nie sú oficiálne podporované
• Sú tiež ťažko aktualizovateľné po inštalácii
• Namiesto toho použite jednu z dvoch možností vľavo

Pred začiatkom si pripravte počítač s macOS, Windows alebo Linuxom a uistite sa, že dokáže otvoriť terminál a pristupovať k GitHubu. Ak plánujete nainštalovať Hermes na externý disk, najprv ho pripojte a potvrďte, že má dostatok voľného miesta.

Prvá inštalácia a spustenie

Ak chcete grafickú aplikáciu

Prejdite do sekcie sťahovania na webovej stránke Hermes a stiahnite si inštalátor pre váš operačný systém. Inštalátor už obsahuje runtime prostredie, takže pri prvom otvorení nie je potrebné nič lokálne kompilovať.

• macOS: Otvorte DMG a presuňte Hermes.app do Aplikácií. DMG je inštalačný obraz bežne používaný na macOS. Tento inštalátor podporuje iba Apple silicon; počítače Mac s procesorom Intel nie sú podporované.
• Windows: Otvorte súbor .appinstaller pomocou Windows App Installer. Nainštaluje podpísaný MSIX, typ balíka aplikácií používaný systémom Windows.
• Linux: Desktopové inštalátory sú pre macOS a Windows. Na Linuxe použite nižšie uvedený terminálový príkaz. Po inštalácii môžete spustiť hermes desktop.

Ak potrebujete iba terminál

Ak používate Linux, macOS alebo WSL2, spustite toto v termináli:

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

Pri používaní PowerShell, ktorý je súčasťou Windows, spustite:

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

Inštalátor stiahne kód Hermes a programy potrebné na jeho spustenie. Ak sa sťahovanie preruší, spustite rovnaký príkaz znova. Po dokončení inštalácie zatvorte aktuálny terminál, otvorte nové okno a zadajte:

hermes

Ak vidíte výzvu Hermes, príkaz je pripravený na použitie. Potom môžete spustiť hermes doctor; táto kontrola inštalácie vám povie, čo ešte chýba.

Uloženie programu na externý disk

K 9. 10. 2026 bol Hermes Agent v0.21.6 nainštalovaný na externý disk pripojený k Macu. Program bol uložený v /Volumes/AItools/tools/hermes-agent, príkaz spúšťača sa nachádzal v ~/.local/bin/hermes, a konfiguračné údaje a údaje konverzácií zostali v ~/.hermes.

Ak má váš disk iný názov, nahraďte cestu za --dir vlastným priečinkom. Disk musí zostať pripojený, kým Hermes beží.

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ávajte tu

Príkaz

~/.local/bin/hermes

• Zadajte hermes v termináli
• Prejaví sa po otvorení nového okna

Konfigurácia a chaty

~/.hermes

• config.yaml je tu
• Pred odpojením disku ukončite

Získanie hodnôt pripojenia z OmniProxy

Tu sa Hermes pripája k OmniProxy namiesto priameho pripojenia ku Grok alebo Gemini. Nakonfigurujte adresy URL služieb Grok a Gemini v OmniProxy; nezadávajte ich priamo v Hermes.

Váš počítač

Hermes

→

Lokálna brána

OmniProxy

• Zahrňte /v1 do adresy

→

Grok

• grok-4.7

Gemini

• gemini-3.8-flash

ID modelu je presný názov, ktorý API používa na identifikáciu modelu. Pre tieto dva modely použite nasledujúce názvy:

• Pre Grok zadajte grok-4.7. API xAI je https://api.x.ai/v1, a požiadavky chatu používajú /v1/chat/completions. Pozri dokumentáciu modelu Grok.
• Pre Gemini zadajte gemini-3.8-flash. API spoločnosti Google kompatibilné s OpenAI je https://generativelanguage.googleapis.com/v1beta/openai/. Pozri dokumentáciu kompatibility Gemini s OpenAI.

Ak chcete prepnúť Hermes na Gemini, zmeňte iba názov modelu na gemini-3.8-flash. Naďalej používajte adresu OmniProxy ako koncový bod API.

Skopírujte adresu URL koncového bodu a kľúč z OmniProxy, potom zadajte zodpovedajúce 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 ktorý Hermes odosiela požiadavky. Musí končiť na /v1 tu. API Key je kľúč, ktorý OmniProxy vydáva pre Hermes. Nahraďte zástupný symbol vlastnou hodnotou a nezverejňujte ho na verejnej stránke.

Ak vaša lokálna inštancia OmniProxy nevyžaduje kľúč, môžete API Key nechať prázdny. Ak je adresa prístupná komukoľvek inému, mali by ste použiť kľúč. Tiež potvrďte, že adresa je dosiahnuteľná z prostredia, kde Hermes beží. Ak sú Hermes a OmniProxy v rovnakom počítači, môžete použiť lokálnu adresu.

Zadanie konfigurácie nástroja

Najprv ukončite aktuálny chat, potom spustite toto v termináli:

hermes model

Vyberte Custom endpoint (self-hosted / VLLM / etc.). Vlastný koncový bod znamená, že Hermes sa pripája k adrese služby, ktorú špecifikujete, namiesto použitia prednastaveného poskytovateľa.

Sprievodca nastavením postupne požiada o adresu URL koncového bodu, kľúč a názov modelu. Zadajte tri hodnoty z predchádzajúcej časti. Ak chcete použiť Gemini, zadajte gemini-3.8-flash ako názov modelu.

Môžete tiež upraviť ~/.hermes/config.yaml priamo. YAML je textový formát, ktorý používa odsadenie na znázornenie konfiguračných vzťahov. Nasledujúca konfigurácia používa Grok:

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

Ak chcete použiť Gemini, zmeňte default na gemini-3.8-flash a ostatné tri hodnoty ponechajte nezmenené:

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í spustite hermes znova a začnite nový chat. V už otvorenej relácii, /model môže prepínať iba medzi poskytovateľmi, ktorí už boli uložení; nemôže pridať túto konfiguráciu.

Overenie skutočnou úlohou

1

hermes doctor

• Kontrola inštalácie prešla

2

Odošlite krátku správu

• Pozrite si odpoveď od Hermes

3

Otvorte protokoly požiadaviek

• Overte názov modelu

1. Spustite hermes doctor na kontrolu, či je inštalácia dokončená.
2. Spustite hermes a požiadajte ho, aby jednou vetou vysvetlil, čo dokáže. Mali by ste vidieť odpoveď.
3. Otvorte protokol požiadaviek OmniProxy, potvrďte, že požiadavka prišla z Hermes, a skontrolujte, či je názov modelu grok-4.7 alebo gemini-3.8-flash.

Vidieť, že sa sprievodca nastavením úspešne uložil, alebo že API vrátilo úspešnú odpoveď, nestačí na to, aby sa ukázalo, že Hermes môže za vás dokončiť úlohy. Názov modelu v protokole požiadaviek sa musí zhodovať s hodnotou, ktorú ste zadali.

Ak chcete chatovať v prehliadači, spustite lokálne nasledujúce:

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

Potom otvorte http://127.0.0.1:9119. Táto adresa funguje iba v aktuálnom počítači.

Bežné chyby

• Zadanie hermes nahlási, že príkaz nemožno nájsť: Zatvorte terminál a otvorte nové okno. Ak príkaz stále nie je nájdený, potvrďte, že ~/.local/bin je v PATH. PATH je zoznam adresárov, kde systém hľadá príkazy. Vo Windows potvrďte, že spúšťací adresár pridaný inštalátorom je v PATH.
• Sťahovanie inštalácie sa v polovici zastaví: Spustite rovnaký inštalačný príkaz znova. Už stiahnuté časti sa znova použijú.
• Hermes neodpovedá alebo hlási, že sa nemôže pripojiť: Potvrďte, že OmniProxy beží, a skontrolujte, či Base URL končí na /v1. Ak Hermes beží v Dockeri a OmniProxy beží na hostiteľovi, nepoužívajte 127.0.0.1, ak je platná iba vo vnútri kontajnera.
• Zobrazí sa chyba kľúča: Aktualizujte kľúč OmniProxy, potom zmeňte api_key v config.yaml. Kľúč xAI alebo Google patrí do nastavení poskytovateľa OmniProxy; nezadávajte ho do tohto poľa Hermes.
• Model je nahlásený ako nedostupný: Otvorte aktuálny zoznam modelov v OmniProxy a skopírujte grok-4.7 alebo gemini-3.8-flash presne tak, ako sa zobrazuje v zozname.
• Hermes odpovedá, ale nemôže vykonávať úlohy, ako je čítanie súborov alebo vykonávanie príkazov: Prepnite na iný model v OmniProxy, ktorý má tieto schopnosti, potom začnite novú reláciu Hermes.
• Program je na externom disku a hermes doctor nahlási chybu úložiska po odpojení disku: Najprv znova pripojte disk. Nedovoľte Hermes vytvoriť samostatnú konfiguráciu, kým je disk odpojený.

Referencie

Postup inštalácie nájdete v dokumentácii inštalácie Hermes a podpore platforiem. Pre konfiguráciu vlastného koncového bodu pozri dokumentáciu poskytovateľa Hermes. Pre ID modelov pozri dokumentáciu modelu Grok a dokumentáciu kompatibility Gemini s OpenAI.

Proces inštalácie na macOS bol dokončený 9. 10. 2026 pomocou Hermes Agent v0.21.6. grok-4.7 a gemini-3.8-flash boli štandardné ID modelov v dokumentácii xAI a Google k tomuto dátumu. Pri zadávaní hodnôt použite názvy zobrazené v OmniProxy.

Nahraďte každú zástupnú hodnotu hodnotami z vašej vlastnej konfigurácie OmniProxy. Nikdy nezverejňujte skutočný kľúč.

Uložený výsledok alebo HTTP 200 sám o sebe nepreukazuje plnú kompatibilitu Agentov. Skontrolujte zdroj a model v zázname volania OmniProxy.

Oficiálne zdroje · Hermes ↗