Namestitev Hermes in konfiguracija OmniProxy

Hermes je pomočnik, ki lahko ohrani pogovore in izkušnje z nalogami, s čimer dokončano delo spremeni v veščine, ki jih je mogoče pozneje ponovno uporabiti. 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. Pošljete mu lahko preglede kode, zapiske o incidentih ali gradiva za stranke iz svojih običajnih orodij za klepet, nato pa se vrne v repozitorij in nadaljuje z delom.

Preden začnete

Najprej izberite metodo namestitve glede na operacijski sistem vašega računalnika. macOS in Windows lahko neposredno uporabljata grafične namestitvene programe, medtem ko Linux, macOS in WSL2 lahko uporabljajo 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
• Prav tako jih je težko posodobiti po namestitvi
• Namesto tega uporabite eno od dveh možnosti na levi

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

Namestitev in prvi 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 .appinstaller datoteko z Windows App Installer. Namesti podpisani MSIX, vrsto paketa aplikacij, ki ga uporablja Windows.
• Linux: Namizni namestitveni programi 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 njegovo 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 pove, kaj še manjka.

Shranjevanje programa na zunanji pogon

9. oktobra 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, konfiguracija in podatki pogovorov 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
• Začne veljati 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 namesto 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 natančno ime, ki ga API uporablja za identifikacijo modela. Za modela uporabite naslednji imeni:

• 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, samo spremenite 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

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

Če vaš lokalni primerek OmniProxy ne zahteva ključa, lahko API ključ pustite prazen. Če je naslov dostopen komur koli drugemu, morate uporabiti ključ. Prav tako potrdite, 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.). Končna točka po meri pomeni, da se Hermes poveže na naslov 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 /model lahko preklaplja samo med ponudniki, ki so že bili shranjeni; te konfiguracije ne more dodati.

Preverjanje s pravo nalogo

1

hermes doctor

• Preverjanje namestitve uspešno

2

Pošljite kratko sporočilo

• Oglejte si odgovor Hermesa

3

Odprite dnevnike zahtev

• Preverite ime modela

1. Zaženite hermes doctor za preverjanje, 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 Hermesa, 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 lahko Hermes 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 imenikov, kjer sistem išče ukaze. V sistemu Windows potrdite, da je zagonski imenik, ki ga je dodal namestitveni program, v PATH.
• Prenos namestitve se na polovici ustavi: 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 osnovni 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 samo znotraj vsebnika.
• Prikaže se napaka ključa: Posodobite ključ OmniProxy, nato spremenite api_key v config.yaml. Ključ xAI ali Google sodi 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 natančno tako, kot se prikaže na seznamu.
• Hermes se odziva, 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 po odklopu pogona poroča o napaki shranjevanja: 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 na 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 standardna ID-ja modelov v dokumentaciji xAI in Google na tisti dan. 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 agenta. Preverite vir in model v zapisu klica OmniProxy.

Uradni viri · Hermes ↗