„Hermes“ diegimas ir „OmniProxy“ konfigūravimas

„Hermes“ yra asistentas, galintis išlaikyti pokalbius ir užduočių patirtį, paverčiant atliktą darbą įgūdžiais, kuriuos galima pakartotinai panaudoti vėliau. Per vieną šliuzą (Gateway) jis taip pat gali prisijungti prie „Telegram“, „Discord“, „Slack“, „WhatsApp“, „Signal“ ir terminalo. Šliuzas tarnauja kaip vieningas įėjimo taškas pranešimams gauti ir persiųsti. Galite siųsti jam kodo peržiūras, incidentų pastabas ar klientų medžiagą iš savo įprastų pokalbių įrankių, tada leisti jam grįžti į saugyklą ir tęsti darbą.

Prieš pradedant

Pirmiausia pasirinkite diegimo būdą pagal savo kompiuterio operacinę sistemą. „macOS“ ir „Windows“ gali tiesiogiai naudoti grafines diegimo programas, o „Linux“, „macOS“ ir „WSL2“ gali naudoti terminalo scenarijų. „WSL2“ yra „Windows“ funkcija, skirta „Linux“ aplinkai paleisti. „Termux“ „Android“ telefonuose ir „Docker“ turi savo diegimo būdus, tačiau šiame vadove aprašomas tik diegimas įprastuose kompiuteriuose.

Norite lango

„macOS“, „Windows“

• „macOS“: atidarykite „DMG“
• „Windows“: atidarykite diegimo programą
• Įdiekite programą sistemoje

Tik terminalas

„Linux“, „macOS“, „WSL2“

• Viena „install.sh“ komanda
• Naudokite „install.ps1“ „Windows“ sistemoje
• Po diegimo įveskite „hermes“

Dar nenaudokite šių

„pip“, „brew“, „AUR“

• Šie diegimo būdai oficialiai nepalaikomi
• Juos taip pat sunku atnaujinti po diegimo
• Vietoj to naudokite vieną iš dviejų kairėje esančių parinkčių

Prieš pradedant, paruoškite „macOS“, „Windows“ arba „Linux“ kompiuterį ir įsitikinkite, kad jis gali atidaryti terminalą ir pasiekti „GitHub“. Jei planuojate įdiegti „Hermes“ išoriniame diske, pirmiausia prijunkite diską ir patvirtinkite, kad jame yra pakankamai laisvos vietos.

Diegimas ir pirmasis paleidimas

Jei norite grafinės programos

Eikite į atsisiuntimų skyrių „Hermes“ svetainėje ir atsisiųskite savo operacinei sistemai skirtą diegimo programą. Diegimo programoje jau yra vykdymo aplinka, todėl pirmą kartą atidarius nieko nereikia kompiliuoti vietoje.

• „macOS“: Atidarykite „DMG“ ir perkelkite Hermes.app į „Applications“. „DMG“ yra „macOS“ sistemoje dažniausiai naudojamas diegimo vaizdas. Ši diegimo programa palaiko tik „Apple silicon“; „Intel Mac“ kompiuteriai nepalaikomi.
• „Windows“: Atidarykite .appinstaller failą su „Windows App Installer“. Jis įdiegia pasirašytą „MSIX“ – „Windows“ naudojamą programų paketų tipą.
• „Linux“: Darbalaukio diegimo programos skirtos „macOS“ ir „Windows“. „Linux“ sistemoje naudokite žemiau pateiktą terminalo komandą. Po diegimo galite vykdyti hermes desktop.

Jei jums reikia tik terminalo

Jei naudojate „Linux“, „macOS“ arba „WSL2“, terminale vykdykite:

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

Naudodami „PowerShell“, įtrauktą į „Windows“, vykdykite:

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

Diegimo programa atsisiunčia „Hermes“ kodą ir programas, reikalingas jam paleisti. Jei atsisiuntimas nutrūksta, vykdykite tą pačią komandą dar kartą. Baigę diegimą, uždarykite dabartinį terminalą, atidarykite naują langą ir įveskite:

hermes

Jei matote „Hermes“ raginimą, komanda paruošta naudoti. Tada galite vykdyti hermes doctor; šis diegimo patikrinimas parodo, ko dar trūksta.

Programos saugojimas išoriniame diske

2026-10-09 „Hermes Agent v0.21.6“ buvo įdiegta išoriniame diske, prijungtame prie „Mac“. Programa buvo saugoma /Volumes/AItools/tools/hermes-agent, paleidimo komanda buvo ~/.local/bin/hermes, o konfigūracijos ir pokalbių duomenys liko ~/.hermes.

Jei jūsų diskas turi kitą pavadinimą, pakeiskite kelią po --dir savo aplanku. Diskas turi likti prijungtas, kol „Hermes“ veikia.

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

Programa

Išorinis diskas

• tools/hermes-agent
• Laikykite kodą čia

Komanda

~/.local/bin/hermes

• Įveskite „hermes“ terminale
• Įsigalioja atidarius naują langą

Konfigūracija ir pokalbiai

~/.hermes

• config.yaml yra čia
• Išeikite prieš atjungdami diską

Gaukite ryšio vertes iš „OmniProxy“

Čia „Hermes“ jungiasi prie „OmniProxy“, o ne tiesiogiai prie „Grok“ ar „Gemini“. Konfigūruokite „Grok“ ir „Gemini“ paslaugų URL „OmniProxy“; neįveskite jų tiesiogiai „Hermes“.

Jūsų kompiuteris

„Hermes“

→

Vietinis šliuzas

„OmniProxy“

• Įtraukite /v1 į adresą

→

„Grok“

• grok-4.7

„Gemini“

• gemini-3.8-flash

Modelio ID yra tikslus pavadinimas, kurį API naudoja modeliui identifikuoti. Šiems dviem modeliams naudokite šiuos pavadinimus:

• „Grok“ įveskite grok-4.7. „xAI“ API yra https://api.x.ai/v1, o pokalbių užklausos naudoja /v1/chat/completions. Žr. „Grok“ modelių dokumentaciją.
• „Gemini“ įveskite gemini-3.8-flash. „Google“ „OpenAI“ suderinama API yra https://generativelanguage.googleapis.com/v1beta/openai/. Žr. „Gemini“ „OpenAI“ suderinamumo dokumentaciją.

Norėdami perjungti „Hermes“ į „Gemini“, tik pakeiskite modelio pavadinimą į gemini-3.8-flash. Toliau naudokite „OmniProxy“ adresą kaip API galinį tašką.

Nukopijuokite galinio taško URL ir raktą iš „OmniProxy“, tada įveskite atitinkamą modelio ID:

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

„Base URL“ yra galinis taškas, į kurį „Hermes“ siunčia užklausas. Jis turi baigtis /v1 čia. „API Key“ yra raktas, kurį „OmniProxy“ išduoda „Hermes“. Pakeiskite vietos rezervavimo ženklą savo verte ir neskelbkite jo viešame puslapyje.

Jei jūsų vietiniam „OmniProxy“ egzemplioriui nereikia rakto, galite palikti „API Key“ tuščią. Jei adresas pasiekiamas kam nors kitam, turėtumėte naudoti raktą. Taip pat patvirtinkite, kad adresas pasiekiamas iš aplinkos, kurioje veikia „Hermes“. Jei „Hermes“ ir „OmniProxy“ yra tame pačiame kompiuteryje, galite naudoti vietinį adresą.

Įrankio konfigūravimas

Pirmiausia išeikite iš dabartinio pokalbio, tada terminale vykdykite:

hermes model

Pasirinkite Custom endpoint (self-hosted / VLLM / etc.). „Custom endpoint“ reiškia, kad „Hermes“ jungiasi prie jūsų nurodyto paslaugos adreso, o ne naudoja iš anksto nustatytą teikėją.

Sąrankos vedlys nuosekliai prašo galinio taško URL, rakto ir modelio pavadinimo. Įveskite tris vertes iš ankstesnio skyriaus. Norėdami naudoti „Gemini“, įveskite gemini-3.8-flash kaip modelio pavadinimą.

Taip pat galite redaguoti ~/.hermes/config.yaml tiesiogiai. „YAML“ yra teksto formatas, naudojantis įtraukas konfigūracijos ryšiams atvaizduoti. Šioje konfigūracijoje naudojamas „Grok“:

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

Norėdami naudoti „Gemini“, pakeiskite default į gemini-3.8-flash ir palikite kitas tris vertes nepakeistas:

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

Išsaugoję vėl vykdykite hermes ir pradėkite naują pokalbį. Jau atidarytame seanse, /model gali tik perjungti tarp jau išsaugotų teikėjų; jis negali pridėti šios konfigūracijos.

Patikrinimas su tikra užduotimi

1

hermes doctor

• Diegimo patikrinimas praėjo

2

Išsiųskite trumpą pranešimą

• Pamatysite „Hermes“ atsakymą

3

Atidarykite užklausų žurnalus

• Patikrinkite modelio pavadinimą

1. Vykdykite hermes doctor kad patikrintumėte, ar diegimas baigtas.
2. Vykdykite hermes ir paprašykite jo vienu sakiniu paaiškinti, ką jis gali padaryti. Turėtumėte pamatyti atsakymą.
3. Atidarykite „OmniProxy“ užklausų žurnalą, patvirtinkite, kad užklausa atėjo iš „Hermes“, ir patikrinkite, ar modelio pavadinimas yra grok-4.7 arba gemini-3.8-flash.

Matyti, kad sąrankos vedlys sėkmingai išsaugojo arba kad API grąžino sėkmingą atsakymą, nepakanka parodyti, kad „Hermes“ gali atlikti užduotis už jus. Užklausų žurnale esantis modelio pavadinimas turi atitikti jūsų įvestą vertę.

Norėdami kalbėtis naršyklėje, vietoje vykdykite:

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

Tada atidarykite http://127.0.0.1:9119. Šis adresas veikia tik dabartiniame kompiuteryje.

Dažnos klaidos

• Įvedus hermes pranešama, kad komanda nerasta: Uždarykite terminalą ir atidarykite naują langą. Jei komanda vis tiek nerasta, patvirtinkite, kad ~/.local/bin yra PATH. PATH yra katalogų sąrašas, kuriame sistema ieško komandų. „Windows“ sistemoje patvirtinkite, kad diegimo programos pridėtas paleidimo katalogas yra PATH.
• Diegimo atsisiuntimas nutrūksta: Vykdykite tą pačią diegimo komandą dar kartą. Jau atsisiųstos dalys bus panaudotos pakartotinai.
• „Hermes“ neatsako arba praneša, kad negali prisijungti: Patvirtinkite, kad „OmniProxy“ veikia, ir patikrinkite, ar „Base URL“ baigiasi /v1. Jei „Hermes“ veikia „Docker“ sistemoje, o „OmniProxy“ veikia pagrindiniame kompiuteryje, nenaudokite 127.0.0.1 jei jis galioja tik konteinerio viduje.
• Pasirodo rakto klaida: Atnaujinkite „OmniProxy“ raktą, tada pakeiskite api_key į config.yaml. „xAI“ arba „Google“ raktas priklauso „OmniProxy“ teikėjo nustatymams; neįveskite jo į šį „Hermes“ lauką.
• Pranešama, kad modelis nepasiekiamas: Atidarykite dabartinį modelių sąrašą „OmniProxy“ ir nukopijuokite grok-4.7 arba gemini-3.8-flash tiksliai taip, kaip jis rodomas sąraše.
• „Hermes“ atsako, bet negali atlikti užduočių, pvz., skaityti failų ar vykdyti komandų: Perjunkite į kitą „OmniProxy“ modelį, kuris turi šias galimybes, tada pradėkite naują „Hermes“ seansą.
• Programa yra išoriniame diske, ir hermes doctor praneša apie saugojimo klaidą atjungus diską: Pirmiausia prijunkite diską. Neleiskite „Hermes“ sukurti atskiros konfigūracijos, kol diskas atjungtas.

Nuorodos

Diegimo veiksmus žr. „Hermes“ diegimo dokumentacijoje ir platformų palaikyme. „Custom endpoint“ konfigūraciją žr. „Hermes“ teikėjo dokumentacijoje. Modelių ID žr. „Grok“ modelių dokumentacijoje ir „Gemini“ „OpenAI“ suderinamumo dokumentacijoje.

„macOS“ diegimo procesas buvo baigtas 2026-10-09 naudojant „Hermes Agent v0.21.6“. grok-4.7 ir gemini-3.8-flash buvo standartiniai modelių ID „xAI“ ir „Google“ dokumentacijoje tą dieną. Įvesdami vertes, naudokite „OmniProxy“ rodomus pavadinimus.

Pakeiskite visus rezervuotus laukelius reikšmėmis iš savo „OmniProxy“ konfigūracijos. Niekada neskelbkite tikro rakto.

Vien išsaugoto rezultato ar HTTP 200 nepakanka visapusiškam agento suderinamumui įrodyti. Patikrinkite šaltinį ir modelį „OmniProxy“ užklausos įraše.

Oficialūs šaltiniai · Hermes ↗