A Hermes telepítése és az OmniProxy konfigurálása

A Hermes egy olyan asszisztens, amely megőrzi a beszélgetéseket és a feladatok tapasztalatait, az elvégzett munkát olyan készségekké alakítva, amelyek később újra felhasználhatók. Egyetlen Átjárón keresztül csatlakozhat a Telegramhoz, Discordhoz, Slackhez, WhatsApphoz, Signalhoz és a terminálhoz is. Az Átjáró egységes belépési pontként szolgál az üzenetek fogadására és továbbítására. Küldhet neki kódellenőrzéseket, incidensjegyzeteket vagy ügyfélanyagokat a szokásos csevegőeszközeiből, majd visszatérhet a tárolóhoz, és folytathatja a munkát.

Mielőtt elkezdené

Először válasszon telepítési módszert a számítógépe operációs rendszere alapján. A macOS és a Windows közvetlenül használhat grafikus telepítőket, míg a Linux, a macOS és a WSL2 terminálszkriptet használhat. A WSL2 egy Windows-szolgáltatás Linux-környezet futtatására. Az Android telefonokon lévő Termux és a Docker saját telepítési módszerekkel rendelkezik, de ez az útmutató csak a normál számítógépekre történő telepítést fedi le.

Ablakot szeretne

macOS, Windows

macOS: nyissa meg a DMG-t
Windows: nyissa meg a telepítőt
Telepítse az alkalmazást a rendszerre

Csak terminál

Linux, macOS, WSL2

Egy install.sh parancs
Használja az install.ps1-et Windowson
Telepítés után írja be a hermes parancsot

Még ne használja ezeket

pip, brew, AUR

Ezek a telepítési módszerek hivatalosan nem támogatottak
Telepítés után nehéz őket frissíteni is
Használja inkább a bal oldali két lehetőség egyikét

Ez az útmutató két útvonalat fed le: grafikus telepítők és terminálszkriptek. A pip, a brew és az AUR nem hivatalosan támogatott telepítési módszerek.

Mielőtt elkezdené, készítsen elő egy macOS, Windows vagy Linux számítógépet, és győződjön meg róla, hogy meg tud nyitni egy terminált és el tudja érni a GitHubot. Ha a Hermest külső meghajtóra szeretné telepíteni, először csatlakoztassa a meghajtót, és erősítse meg, hogy elegendő szabad hely van rajta.

Telepítés és első indítás

Ha grafikus alkalmazást szeretne

Lépjen a Hermes weboldal letöltési szakaszára, és töltse le az operációs rendszerének megfelelő telepítőt. A telepítő már tartalmazza a futtatókörnyezetet, így semmit sem kell helyileg lefordítani az első megnyitáskor.

macOS: Nyissa meg a DMG-t, és helyezze a Hermes.app fájlt az Alkalmazások mappába. A DMG egy macOS-en gyakran használt telepítési képfájl. Ez a telepítő csak Apple silicont támogat; az Intel Macek nem támogatottak.
Windows: Nyissa meg a .appinstaller fájlt a Windows Alkalmazástelepítővel. Egy aláírt MSIX-et telepít, amely a Windows által használt alkalmazáscsomag-típus.
Linux: Az asztali telepítők macOS-re és Windowsra valók. Linuxon használja az alábbi terminálparancsot. A telepítés után futtathatja a hermes desktopparancsot.

Ha csak a terminálra van szüksége

Ha Linuxot, macOS-t vagy WSL2-t használ, futtassa ezt a terminálban:

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

Amikor a Windows-hoz mellékelt PowerShellt használja, futtassa:

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

A telepítő letölti a Hermes kódot és a futtatásához szükséges programokat. Ha a letöltés megszakad, futtassa újra ugyanazt a parancsot. A telepítés befejezése után zárja be az aktuális terminált, nyisson meg egy új ablakot, és írja be:

hermes

Ha látja a Hermes parancssort, a parancs használatra kész. Ezután futtathatja a hermes doctorparancsot; ez a telepítésellenőrzés megmondja, mi hiányzik még.

A program tárolása külső meghajtón

október 9-én a Hermes Agent v0.21.6-ot egy Machez csatlakoztatott külső meghajtóra telepítették. A program a /Volumes/AItools/tools/hermes-agenthelyen volt tárolva, az indítóparancs a ~/.local/bin/hermeshelyen volt, a konfigurációs és beszélgetési adatok pedig a ~/.hermeshelyen maradtak.

Ha a meghajtója más nevű, cserélje le a --dir utáni elérési utat a saját mappájára. A meghajtónak csatlakoztatva kell maradnia, amíg a Hermes fut.

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

Program

Külső meghajtó

tools/hermes-agent
Tartsa itt a kódot

Parancs

~/.local/bin/hermes

Írja be a hermes parancsot a terminálba
Új ablak megnyitása után lép életbe

Konfiguráció és csevegések

~/.hermes

a config.yaml itt van
Lépjen ki a meghajtó leválasztása előtt

Így voltak elrendezve a fájlok azon a Macen. Az alapértelmezett telepítés a programot a felhasználói könyvtárba helyezi, ugyanazzal az eredménnyel: nyisson meg egy új terminált, és írja be a hermes parancsot.

Csatlakozási értékek beszerzése az OmniProxyból

Itt a Hermes az OmniProxyhoz csatlakozik, nem közvetlenül a Grokhoz vagy a Geminihez. Konfigurálja a Grok és Gemini szolgáltatási URL-eket az OmniProxyban; ne írja be őket közvetlenül a Hermesbe.

Számítógépe

Hermes

Helyi átjáró

OmniProxy

Tartalmazza a /v1-et a címben

Grok

grok-4.7

Gemini

gemini-3.8-flash

A Hermes látja az OmniProxy-t. Az OmniProxy továbbítja a kéréseket a Groknak és a Gemininek.

A modellazonosító az a pontos név, amelyet az API egy modell azonosítására használ. Használja a következő neveket a két modellhez:

Grokhoz írja be: grok-4.7. Az xAI API a https://api.x.ai/v1, és a csevegési kérések a /v1/chat/completionscímet használják. Lásd a Grok modell dokumentációját.
Geminihez írja be: gemini-3.8-flash. A Google OpenAI-kompatibilis API-ja a https://generativelanguage.googleapis.com/v1beta/openai/. Lásd a Gemini OpenAI-kompatibilitási dokumentációját.

A Hermes Geminire való átkapcsolásához csak módosítsa a modellnevet a gemini-3.8-flashértékre. Továbbra is használja az OmniProxy címet API-végpontként.

Másolja ki az OmniProxyból az API-végpont URL-jét és kulcsát, majd írja be a megfelelő modellazonosítót:

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

Az alap URL az a végpont, amelyre a Hermes a kéréseket küldi. Itt a /v1 értékkel kell végződnie. Az API-kulcs az a kulcs, amelyet az OmniProxy kiad a Hermesnek. Cserélje le a helyőrzőt a saját értékére, és ne tegye közzé nyilvános oldalon.

Ha a helyi OmniProxy-példány nem igényel kulcsot, az API-kulcsot üresen hagyhatja. Ha a cím mások számára is elérhető, használjon kulcsot. Erősítse meg azt is, hogy a cím elérhető abból a környezetből, ahol a Hermes fut. Ha a Hermes és az OmniProxy ugyanazon a számítógépen van, használhat helyi címet.

Az eszköz konfigurálása

Először lépjen ki az aktuális csevegésből, majd futtassa ezt a terminálban:

hermes model

Válassza az Egyéni végpont (saját üzemeltetésű / VLLM / stb.) lehetőséget. Az egyéni végpont azt jelenti, hogy a Hermes egy Ön által megadott szolgáltatási címhez csatlakozik, ahelyett, hogy előre beállított szolgáltatót használna.

A telepítővarázsló sorrendben kéri a végpont URL-jét, a kulcsot és a modellnevet. Írja be az előző szakaszból származó három értéket. A Gemini használatához írja be a gemini-3.8-flash értéket modellnévként.

Szerkesztheti a ~/.hermes/config.yaml fájlt is közvetlenül. A YAML egy szöveges formátum, amely behúzást használ a konfigurációs kapcsolatok megjelenítésére. A következő konfiguráció a Grokot használja:

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

A Gemini használatához módosítsa a default értéket a gemini-3.8-flash értékre, és hagyja a másik három értéket változatlanul:

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

Mentés után futtassa újra a hermes parancsot, és indítson új csevegést. Egy már megnyitott munkamenetben a /model csak a már mentett szolgáltatók között tud váltani; nem tudja hozzáadni ezt a konfigurációt.

Ellenőrzés valódi feladattal

hermes doctor

A telepítésellenőrzés sikeres

Küldjön egy rövid üzenetet

Lásson választ a Hermestől

Nyissa meg a kérésnaplókat

Ellenőrizze a modellnevet

A konfiguráció csak a három lépés befejezése után használható.

Futtassa a hermes doctor parancsot a telepítés teljességének ellenőrzéséhez.
Futtassa a hermes parancsot, és kérje meg, hogy egy mondatban magyarázza el, mit tud tenni. Választ kell kapnia.
Nyissa meg az OmniProxy kérésnaplóját, erősítse meg, hogy a kérés a Hermestől érkezett, és ellenőrizze, hogy a modellnév grok-4.7 vagy gemini-3.8-flashértékű-e.

Annak látása, hogy a telepítővarázsló sikeresen mentett, vagy hogy az API sikeres választ adott, nem elég annak bizonyítására, hogy a Hermes feladatokat tud elvégezni Önnek. A kérésnaplóban szereplő modellnévnek meg kell egyeznie a megadott értékkel.

Böngészőben való csevegéshez futtassa helyileg a következőt:

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

Majd nyissa meg a http://127.0.0.1:9119címet. Ez a cím csak az aktuális számítógépen működik.

Gyakori hibák

A hermes beírása azt jelenti, hogy a parancs nem található: Zárja be a terminált, és nyisson meg egy új ablakot. Ha a parancs továbbra sem található, erősítse meg, hogy a ~/.local/bin szerepel a PATH-ban. A PATH azon könyvtárak listája, ahol a rendszer parancsokat keres. Windowson erősítse meg, hogy a telepítő által hozzáadott indítási könyvtár szerepel a PATH-ban.
A telepítés letöltése félúton leáll: Futtassa újra ugyanazt a telepítési parancsot. A már letöltött részek újra felhasználásra kerülnek.
A Hermes nem válaszol, vagy azt jelenti, hogy nem tud csatlakozni: Erősítse meg, hogy az OmniProxy fut, és ellenőrizze, hogy az Alap URL a /v1értékkel végződik-e. Ha a Hermes Dockerben fut, míg az OmniProxy a gazdagépen, ne használja a 127.0.0.1 címet, ha az csak a tárolón belül érvényes.
Kulcshiba jelenik meg: Frissítse az OmniProxy-kulcsot, majd módosítsa a api_key értéket a config.yamlfájlban. Az xAI vagy Google kulcs az OmniProxy szolgáltatói beállításaiba való; ne írja be ebbe a Hermes-mezőbe.
A modell nem elérhetőként jelenik meg: Nyissa meg az aktuális modell-listát az OmniProxyban, és másolja ki a grok-4.7 vagy a gemini-3.8-flash értéket pontosan úgy, ahogy a listában szerepel.
A Hermes válaszol, de nem tud feladatokat elvégezni, például fájlokat olvasni vagy parancsokat végrehajtani: Váltson át egy másik modellre az OmniProxyban, amely rendelkezik ezekkel a képességekkel, majd indítson új Hermes-munkamenetet.
A program külső meghajtón van, és a hermes doctor tárolási hibát jelent a meghajtó leválasztása után: Először csatlakoztassa újra a meghajtót. Ne hagyja, hogy a Hermes külön konfigurációt hozzon létre, amíg a meghajtó le van választva.

Hivatkozások

A telepítési lépésekért lásd: Hermes installation documentation és platform support. Az egyéni végpont konfigurálásáért lásd: Hermes Provider documentation. A modellazonosítókért lásd: Grok model documentation és Gemini’s OpenAI compatibility documentation.

A macOS telepítési folyamata 2026. október 9-én fejeződött be a Hermes Agent v0.21.6 verzióval. grok-4.7 és gemini-3.8-flash voltak a szabványos modellazonosítók az xAI és a Google dokumentációjában azon a napon. Az értékek megadásakor használja az OmniProxyban megjelenő neveket.

Helyettesítse az összes helykitöltőt a saját OmniProxy-konfigurációjából származó értékekkel. Soha ne publikáljon valódi kulcsot.

Egy mentett eredmény vagy HTTP 200 önmagában nem bizonyítja a teljes ügynök kompatibilitást. Ellenőrizze a forrást és a modellt az OmniProxy hívásnaplójában.

Hivatalos források · Hermes ↗