Namestitev orodja Hermes in konfiguracija OmniProxy

Hermes je pomočnik, ki lahko ohrani pogovore in izkušnje z nalogami ter dokončano delo spremeni v veščine, ki jih lahko pozneje znova uporabite. Prek enotnega prehoda (Gateway) se lahko poveže tudi s Telegramom, Discordom, Slackom, WhatsAppom, Signalom in terminalom. Prehod služi kot enotna vstopna točka za prejemanje in posredovanje sporočil. Iz svojih običajnih orodij za klepet mu lahko pošljete preglede kode, zapiske o incidentih ali gradiva za stranke, nato pa se vrnete v repozitorij in nadaljujete z delom.

Preden začnete

Najprej izberite metodo namestitve glede na operacijski sistem vašega računalnika. macOS in Windows lahko neposredno uporabita grafične namestitvene programe, medtem ko Linux, macOS in WSL2 lahko uporabijo terminalski skript. WSL2 je funkcija sistema Windows za zagon okolja Linux. Termux na telefonih Android in Docker imata svoje metode namestitve, vendar ta vodnik zajema le namestitev v običajnih računalnikih.

Želite okno

macOS, Windows

• macOS: odprite DMG
• Windows: odprite namestitveni program
• Namestite aplikacijo v sistem

Samo terminal

Linux, macOS, WSL2

• En ukaz install.sh
• Uporabite install.ps1 v sistemu Windows
• Po namestitvi vnesite hermes

Tega še ne uporabljajte

pip, brew, AUR

• Te metode namestitve niso uradno podprte
• Po namestitvi jih je tudi težko posodobiti
• Namesto tega uporabite eno od dveh možnosti na levi

Pred začetkom pripravite računalnik s sistemom macOS, Windows ali Linux in se prepričajte, da lahko odpre terminal in dostopa do GitHub. Če nameravate Hermes namestiti na zunanji pogon, najprej priključite pogon in potrdite, da ima dovolj prostega prostora.

Prva namestitev in zagon

Če želite grafično aplikacijo

Pojdite na razdelek za prenos na spletnem mestu Hermes in prenesite namestitveni program za svoj operacijski sistem. Namestitveni program že vključuje izvajalno okolje, zato ob prvem odprtju ni treba ničesar lokalno prevajati.

• macOS: Odprite DMG in premaknite Hermes.app v Applications. DMG je namestitvena slika, ki se običajno uporablja v sistemu macOS. Ta namestitveni program podpira samo Apple silicon; računalniki Mac z Intelom niso podprti.
• Windows: Odprite datoteko .appinstaller z Windows App Installer. Namesti podpisani MSIX, vrsto paketa aplikacij, ki ga uporablja Windows.
• Linux: Namestitveni programi za namizje so za macOS in Windows. V Linuxu uporabite spodnji ukaz terminala. Po namestitvi lahko zaženete hermes desktop.

Če potrebujete samo terminal

Če uporabljate Linux, macOS ali WSL2, v terminalu zaženite:

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

Pri uporabi PowerShell, vključenega v Windows, zaženite:

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

Namestitveni program prenese kodo Hermes in programe, potrebne za njeno izvajanje. Če je prenos prekinjen, znova zaženite isti ukaz. Po končani namestitvi zaprite trenutni terminal, odprite novo okno in vnesite:

hermes

Če vidite poziv Hermes, je ukaz pripravljen za uporabo. Nato lahko zaženete hermes doctor; ta preverjanje namestitve vam pove, kaj še manjka.

Shranjevanje programa na zunanji pogon

Na dan 9. 10. 2026 je bil Hermes Agent v0.21.6 nameščen na zunanji pogon, priključen na Mac. Program je bil shranjen v /Volumes/AItools/tools/hermes-agent, ukaz za zagon se je nahajal v ~/.local/bin/hermes, konfiguracijski podatki in podatki o pogovorih pa so ostali v ~/.hermes.

Če ima vaš pogon drugo ime, zamenjajte pot za --dir s svojo mapo. Pogon mora ostati priključen, medtem ko Hermes deluje.

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

Program

Zunanji pogon

• tools/hermes-agent
• Kodo hranite tukaj

Ukaz

~/.local/bin/hermes

• V terminalu vnesite hermes
• Učinkuje po odprtju novega okna

Konfiguracija in klepeti

~/.hermes

• config.yaml je tukaj
• Pred odklopom pogona izstopite

Pridobitev vrednosti povezave iz OmniProxy

Tu se Hermes poveže z OmniProxy in ne neposredno z Grok ali Gemini. Konfigurirajte URL-je storitev Grok in Gemini v OmniProxy; ne vnašajte jih neposredno v Hermes.

Vaš računalnik

Hermes

→

Lokalni prehod

OmniProxy

• V naslov vključite /v1

→

Grok

• grok-4.7

Gemini

• gemini-3.8-flash

ID modela je točno ime, ki ga API uporablja za identifikacijo modela. Za oba modela uporabite naslednja imena:

• Za Grok vnesite grok-4.7. API xAI je https://api.x.ai/v1, zahteve za klepet pa uporabljajo /v1/chat/completions. Glejte dokumentacijo modela Grok.
• Za Gemini vnesite gemini-3.8-flash. Googlov API, združljiv z OpenAI, je https://generativelanguage.googleapis.com/v1beta/openai/. Glejte dokumentacijo o združljivosti Gemini z OpenAI.

Če želite Hermes preklopiti na Gemini, spremenite le ime modela v gemini-3.8-flash. Še naprej uporabljajte naslov OmniProxy kot končno točko API-ja.

Kopirajte URL končne točke in ključ iz OmniProxy, nato vnesite ustrezen ID modela:

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

Base URL je končna točka, na katero Hermes pošilja zahteve. Tukaj se mora končati z /v1. API Key je ključ, ki ga OmniProxy izda za Hermes. Zamenjajte nadomestni niz s svojo vrednostjo in ga ne objavljajte na javni strani.

Če vaš lokalni primerek OmniProxy ne zahteva ključa, lahko API Key pustite prazen. Če je naslov dostopen komur koli drugemu, uporabite ključ. Potrdite tudi, da je naslov dosegljiv iz okolja, kjer Hermes deluje. Če sta Hermes in OmniProxy v istem računalniku, lahko uporabite lokalni naslov.

Vnos konfiguracije orodja

Najprej izstopite iz trenutnega klepeta, nato v terminalu zaženite:

hermes model

Izberite Custom endpoint (self-hosted / VLLM / etc.). Custom endpoint pomeni, da se Hermes poveže z naslovom storitve, ki ga določite, namesto da uporabi prednastavljenega ponudnika.

Čarovnik za namestitev zaporedoma zahteva URL končne točke, ključ in ime modela. Vnesite tri vrednosti iz prejšnjega razdelka. Za uporabo Gemini vnesite gemini-3.8-flash kot ime modela.

Uredite lahko tudi ~/.hermes/config.yaml neposredno. YAML je besedilni format, ki uporablja zamik za predstavitev konfiguracijskih odnosov. Naslednja konfiguracija uporablja Grok:

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

Za uporabo Gemini spremenite default v gemini-3.8-flash in pustite ostale tri vrednosti nespremenjene:

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

Po shranjevanju znova zaženite hermes in začnite nov klepet. V že odprti seji lahko /model preklaplja le med ponudniki, ki so že bili shranjeni; te konfiguracije ne more dodati.

Preverjanje z dejansko nalogo

1

hermes doctor

• Preverjanje namestitve uspešno

2

Pošljite kratko sporočilo

• Oglejte si odgovor od Hermes

3

Odprite dnevnike zahtev

• Preverite ime modela

1. Zaženite hermes doctor, da preverite, ali je namestitev končana.
2. Zaženite hermes in ga prosite, naj v enem stavku razloži, kaj lahko stori. Videti bi morali odgovor.
3. Odprite dnevnik zahtev OmniProxy, potrdite, da je zahteva prišla od Hermes, in preverite, ali je ime modela grok-4.7 ali gemini-3.8-flash.

Videti, da je čarovnik za namestitev uspešno shranil ali da je API vrnil uspešen odziv, ni dovolj, da bi pokazalo, da Hermes lahko opravlja naloge namesto vas. Ime modela v dnevniku zahtev se mora ujemati z vrednostjo, ki ste jo vnesli.

Za klepet v brskalniku lokalno zaženite naslednje:

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

Nato odprite http://127.0.0.1:9119. Ta naslov deluje samo v trenutnem računalniku.

Pogoste napake

• Vnos hermes poroča, da ukaza ni mogoče najti: Zaprite terminal in odprite novo okno. Če ukaz še vedno ni najden, potrdite, da je ~/.local/bin v PATH. PATH je seznam map, v katerih sistem išče ukaze. V sistemu Windows potrdite, da je zagonska mapa, ki jo je dodal namestitveni program, v PATH.
• Prenos namestitve se ustavi na polovici: Znova zaženite isti ukaz za namestitev. Že preneseni deli bodo ponovno uporabljeni.
• Hermes se ne odziva ali poroča, da se ne more povezati: Potrdite, da OmniProxy deluje, in preverite, ali se Base URL konča z /v1. Če Hermes deluje v Dockerju, medtem ko OmniProxy deluje na gostitelju, ne uporabljajte 127.0.0.1, če je veljaven le znotraj vsebnika.
• Prikaže se napaka ključa: Posodobite ključ OmniProxy, nato spremenite api_key v config.yaml. Ključ xAI ali Google spada v nastavitve ponudnika OmniProxy; ne vnašajte ga v to polje Hermes.
• Model je prijavljen kot nedostopen: Odprite trenutni seznam modelov v OmniProxy in kopirajte grok-4.7 ali gemini-3.8-flash točno tako, kot se prikaže na seznamu.
• Hermes se odzove, vendar ne more opravljati nalog, kot je branje datotek ali izvajanje ukazov: V OmniProxy preklopite na drug model, ki ima te zmogljivosti, nato začnite novo sejo Hermes.
• Program je na zunanjem pogonu in hermes doctor poroča o napaki shranjevanja po odklopu pogona: Najprej znova priključite pogon. Ne dovolite, da Hermes ustvari ločeno konfiguracijo, medtem ko je pogon odklopljen.

Reference

Za korake namestitve glejte dokumentacijo za namestitev Hermes in podporo za platforme. Za konfiguracijo končne točke po meri glejte dokumentacijo ponudnika Hermes. Za ID-je modelov glejte dokumentacijo modela Grok in dokumentacijo o združljivosti Gemini z OpenAI.

Postopek namestitve za macOS je bil dokončan 9. 10. 2026 z uporabo Hermes Agent v0.21.6. grok-4.7 in gemini-3.8-flash sta bila na ta datum standardna ID-ja modelov v dokumentaciji xAI in Google. Pri vnosu vrednosti uporabite imena, prikazana v OmniProxy.

Zamenjajte vsako mesto z vrednostmi iz vaše lastne konfiguracije OmniProxy. Nikoli ne objavite resničnega ključa.

Shranjen rezultat ali HTTP 200 sam po sebi ne dokazuje popolne združljivosti Agentov. Preverite vir in model v zapisu klica OmniProxy.

Uradni viri · Hermes ↗