Instalacija alata Hermes i konfiguracija za OmniProxy

Hermes je asistent koji može zadržati razgovore i iskustvo zadataka, pretvarajući dovršeni rad u vještine koje se kasnije mogu ponovno koristiti. Kroz jedan pristupnik (Gateway) također se može povezati s Telegramom, Discordom, Slackom, WhatsAppom, Signalom i terminalom. Pristupnik služi kao jedinstvena ulazna točka za primanje i prosljeđivanje poruka. Možete mu poslati recenzije koda, bilješke o incidentima ili materijale za korisnike iz svojih uobičajenih alata za chat, a zatim ga natjerati da se vrati u repozitorij i nastavi raditi.

Prije početka

Prvo odaberite metodu instalacije na temelju operacijskog sustava vašeg računala. macOS i Windows mogu izravno koristiti grafičke instalacijske programe, dok Linux, macOS i WSL2 mogu koristiti terminalsku skriptu. WSL2 je Windows značajka za pokretanje Linux okruženja. Termux na Android telefonima i Docker imaju svoje metode instalacije, ali ovaj vodič pokriva samo instalaciju na običnim računalima.

Želite prozor

macOS, Windows

• macOS: otvorite DMG
• Windows: otvorite instalacijski program
• Instalirajte aplikaciju na sustav

Samo terminal

Linux, macOS, WSL2

• Jedna install.sh naredba
• Koristite install.ps1 na Windowsima
• Unesite hermes nakon instalacije

Još ne koristite ovo

pip, brew, AUR

• Ove metode instalacije nisu službeno podržane
• Također ih je teško ažurirati nakon instalacije
• Umjesto toga koristite jednu od dvije opcije s lijeve strane

Prije početka pripremite macOS, Windows ili Linux računalo i provjerite može li otvoriti terminal i pristupiti GitHub-u. Ako planirate instalirati Hermes na vanjski pogon, prvo ga povežite i potvrdite da ima dovoljno slobodnog prostora.

Instalacija i prvo pokretanje

Ako želite grafičku aplikaciju

Idite na odjeljak za preuzimanje na web stranici Hermes i preuzmite instalacijski program za svoj operacijski sustav. Instalacijski program već uključuje runtime okruženje, tako da se ništa ne mora lokalno kompajlirati kada ga prvi put otvorite.

• macOS: Otvorite DMG i premjestite Hermes.app u Applications. DMG je instalacijska slika koja se obično koristi na macOS-u. Ovaj instalacijski program podržava samo Apple silicon; Intel Mac-ovi nisu podržani.
• Windows: Otvorite .appinstaller datoteku pomoću Windows App Installer-a. Instalira potpisani MSIX, vrstu paketa aplikacije koju koristi Windows.
• Linux: Desktop instalacijski programi su za macOS i Windows. Na Linuxu koristite donju terminalsku naredbu. Nakon instalacije možete pokrenuti hermes desktop.

Ako trebate samo terminal

Ako koristite Linux, macOS ili WSL2, pokrenite ovo u terminalu:

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

Kada koristite PowerShell uključen uz Windows, pokrenite:

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

Instalacijski program preuzima Hermes kod i programe potrebne za njegovo pokretanje. Ako se preuzimanje prekine, ponovno pokrenite istu naredbu. Nakon završetka instalacije, zatvorite trenutni terminal, otvorite novi prozor i unesite:

hermes

Ako vidite Hermes upit, naredba je spremna za upotrebu. Zatim možete pokrenuti hermes doctor; ova provjera instalacije govori vam što još nedostaje.

Pohrana programa na vanjski pogon

Na datum 9. listopada 2026., Hermes Agent v0.21.6 instaliran je na vanjski pogon povezan s Mac-om. Program je pohranjen na /Volumes/AItools/tools/hermes-agent, naredba za pokretanje nalazila se na ~/.local/bin/hermes, a konfiguracija i podaci razgovora ostali su u ~/.hermes.

Ako vaš pogon ima drugačiji naziv, zamijenite put nakon --dir vlastitom mapom. Pogon mora ostati povezan dok Hermes radi.

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

Program

Vanjski pogon

• tools/hermes-agent
• Držite kod ovdje

Naredba

~/.local/bin/hermes

• Unesite hermes u terminal
• Stupa na snagu nakon otvaranja novog prozora

Konfiguracija i razgovori

~/.hermes

• config.yaml je ovdje
• Izađite prije odspajanja pogona

Dohvaćanje vrijednosti povezivanja iz OmniProxy-a

Ovdje se Hermes povezuje na OmniProxy umjesto izravno na Grok ili Gemini. Konfigurirajte URL-ove usluga Grok i Gemini u OmniProxy-u; nemojte ih unositi izravno u Hermes.

Vaše računalo

Hermes

→

Lokalni pristupnik

OmniProxy

• Uključite /v1 u adresu

→

Grok

• grok-4.7

Gemini

• gemini-3.8-flash

ID modela je točan naziv koji API koristi za identifikaciju modela. Koristite sljedeće nazive za dva modela:

• Za Grok unesite grok-4.7. xAI API je https://api.x.ai/v1, a zahtjevi za chat koriste /v1/chat/completions. Pogledajte dokumentaciju Grok modela.
• Za Gemini unesite gemini-3.8-flash. Google-ov OpenAI-kompatibilni API je https://generativelanguage.googleapis.com/v1beta/openai/. Pogledajte dokumentaciju Gemini OpenAI kompatibilnosti.

Za prebacivanje Hermesa na Gemini, samo promijenite naziv modela u gemini-3.8-flash. Nastavite koristiti adresu OmniProxy-a kao API krajnju točku.

Kopirajte URL krajnje točke i ključ iz OmniProxy-a, a zatim unesite odgovarajući ID modela:

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

Base URL je krajnja točka na koju Hermes šalje zahtjeve. Ovdje mora završavati s /v1 . API Key je ključ koji OmniProxy izdaje Hermesu. Zamijenite zamjenski niz vlastitom vrijednošću i nemojte ga objavljivati na javnoj stranici.

Ako vaša lokalna instanca OmniProxy-a ne zahtijeva ključ, možete ostaviti API Key praznim. Ako je adresa dostupna bilo kome drugom, trebali biste koristiti ključ. Također potvrdite da je adresa dostupna iz okruženja u kojem Hermes radi. Ako su Hermes i OmniProxy na istom računalu, možete koristiti lokalnu adresu.

Unos konfiguracije alata

Prvo izađite iz trenutnog chata, a zatim pokrenite ovo u terminalu:

hermes model

Odaberite Custom endpoint (self-hosted / VLLM / etc.). Custom endpoint znači da se Hermes povezuje na adresu usluge koju navedete umjesto korištenja unaprijed postavljenog pružatelja usluga.

Čarobnjak za postavljanje redom traži URL krajnje točke, ključ i naziv modela. Unesite tri vrijednosti iz prethodnog odjeljka. Za korištenje Gemini-a unesite gemini-3.8-flash kao naziv modela.

Također možete izravno urediti ~/.hermes/config.yaml . YAML je tekstualni format koji koristi uvlačenje za prikaz konfiguracijskih odnosa. Sljedeća konfiguracija koristi Grok:

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

Za korištenje Gemini-a promijenite default u gemini-3.8-flash i ostavite ostale tri vrijednosti nepromijenjenima:

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

Nakon spremanja ponovno pokrenite hermes i započnite novi chat. U već otvorenoj sesiji, /model može se prebacivati samo između pružatelja usluga koji su već spremljeni; ne može dodati ovu konfiguraciju.

Provjera sa stvarnim zadatkom

1

hermes doctor

• Provjera instalacije prolazi

2

Pošaljite kratku poruku

• Vidite odgovor od Hermesa

3

Otvorite zapisnike zahtjeva

• Provjerite naziv modela

1. Pokrenite hermes doctor kako biste provjerili je li instalacija dovršena.
2. Pokrenite hermes i zamolite ga da u jednoj rečenici objasni što može učiniti. Trebali biste vidjeti odgovor.
3. Otvorite zapisnik zahtjeva OmniProxy-a, potvrdite da je zahtjev došao od Hermesa i provjerite je li naziv modela grok-4.7 ili gemini-3.8-flash.

Vidjeti da je čarobnjak za postavljanje uspješno spremljen ili da je API vratio uspješan odgovor nije dovoljno da pokaže da Hermes može dovršiti zadatke za vas. Naziv modela u zapisniku zahtjeva mora se podudarati s vrijednošću koju ste unijeli.

Za chat u pregledniku, pokrenite sljedeće lokalno:

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

Zatim otvorite http://127.0.0.1:9119. Ova adresa radi samo na trenutnom računalu.

Uobičajene pogreške

• Unos hermes javlja da naredba nije pronađena: Zatvorite terminal i otvorite novi prozor. Ako naredba i dalje nije pronađena, potvrdite da je ~/.local/bin u PATH-u. PATH je popis direktorija gdje sustav traži naredbe. Na Windowsima potvrdite da je direktorij za pokretanje koji je dodao instalacijski program u PATH-u.
• Preuzimanje instalacije se zaustavlja na pola puta: Ponovno pokrenite istu instalacijsku naredbu. Dijelovi koji su već preuzeti bit će ponovno korišteni.
• Hermes ne odgovara ili javlja da se ne može povezati: Potvrdite da je OmniProxy pokrenut i provjerite završava li Base URL s /v1. Ako Hermes radi u Docker-u dok OmniProxy radi na hostu, nemojte koristiti 127.0.0.1 ako je valjan samo unutar spremnika (container).
• Pojavljuje se pogreška ključa: Ažurirajte OmniProxy ključ, a zatim promijenite api_key u config.yaml. xAI ili Google ključ pripada postavkama pružatelja usluga u OmniProxy-u; nemojte ga unositi u ovo Hermes polje.
• Model je prijavljen kao nedostupan: Otvorite trenutni popis modela u OmniProxy-u i kopirajte grok-4.7 ili gemini-3.8-flash točno onako kako se pojavljuje na popisu.
• Hermes odgovara, ali ne može obavljati zadatke kao što su čitanje datoteka ili izvršavanje naredbi: Prebacite se na drugi model u OmniProxy-u koji ima te mogućnosti, a zatim započnite novu Hermes sesiju.
• Program je na vanjskom pogonu, a hermes doctor javlja pogrešku pohrane nakon odspajanja pogona: Prvo ponovno povežite pogon. Ne dopustite Hermesu da stvori zasebnu konfiguraciju dok je pogon odspojen.

Reference

Za korake instalacije pogledajte dokumentaciju za instalaciju Hermesa i podršku za platforme. Za konfiguraciju Custom endpoint-a pogledajte dokumentaciju za Hermes pružatelje usluga. Za ID-ove modela pogledajte dokumentaciju Grok modela i dokumentaciju Gemini OpenAI kompatibilnosti.

Proces instalacije na macOS-u dovršen je 9. listopada 2026. koristeći Hermes Agent v0.21.6. grok-4.7 i gemini-3.8-flash bili su standardni ID-ovi modela u xAI i Google dokumentaciji na taj datum. Prilikom unosa vrijednosti koristite nazive prikazane u OmniProxy-u.

Zamijenite svaki predložak vrijednostima iz vlastite OmniProxy konfiguracije. Nikada ne objavite stvarni ključ.

Spremljeni rezultat ili HTTP 200 sami po sebi ne dokazuju punu kompatibilnost Agenta. Provjerite izvor i model u zapisu poziva OmniProxy.

Službeni izvori · Hermes ↗