Hermese installimine ja OmniProxy seadistamine

Hermes on assistent, mis suudab säilitada vestlusi ja ülesannete kogemusi, muutes lõpetatud töö oskusteks, mida saab hiljem uuesti kasutada. Ühe lüüsi kaudu saab see ühenduda ka Telegrami, Discordi, Slacki, WhatsAppi, Signali ja terminaliga. Lüüs toimib ühtse sisenemispunktina sõnumite vastuvõtmiseks ja edastamiseks. Saate saata sellele koodiülevaateid, intsidentide märkmeid või kliendimaterjale oma tavalistest vestlustööriistadest, seejärel lasta sellel hoidlasse naasta ja tööd jätkata.

Enne alustamist

Esmalt valige installimismeetod vastavalt oma arvuti operatsioonisüsteemile. macOS ja Windows saavad kasutada graafilisi installijaid otse, samas kui Linux, macOS ja WSL2 saavad kasutada terminaliskripti. WSL2 on Windowsi funktsioon Linuxi keskkonna käitamiseks. Android-telefonide Termuxil ja Dockeril on oma installimismeetodid, kuid see juhend hõlmab ainult tavaliste arvutite installimist.

Soovite akent

macOS, Windows

• macOS: avage DMG
• Windows: avage installija
• Installige rakendus süsteemi

Ainult terminal

Linux, macOS, WSL2

• Üks install.sh käsk
• Kasutage Windowsis install.ps1-i
• Pärast installimist sisestage hermes

Ärge kasutage neid veel

pip, brew, AUR

• Neid installimismeetodeid ametlikult ei toetata
• Neid on ka pärast installimist raske värskendada
• Kasutage selle asemel ühte vasakpoolsetest valikutest

Enne alustamist valmistage ette macOS, Windows või Linux arvuti ja veenduge, et see suudab avada terminali ja pääseda juurde GitHubile. Kui plaanite Hermese installida välisele kettale, ühendage ketas esmalt ja veenduge, et sellel on piisavalt vaba ruumi.

Installimine ja esmakordne käivitamine

Kui soovite graafilist rakendust

Minge Hermese veebisaidi allalaadimisjaotisse ja laadige alla oma operatsioonisüsteemi installija. Installija sisaldab juba käituskeskkonda, seega pole vaja esmakordsel avamisel midagi kohapeal kompileerida.

• macOS: Avage DMG ja teisaldage Hermes.app rakendustesse. DMG on macOS-is tavaliselt kasutatav installipilt. See installija toetab ainult Apple’i kiipi; Inteli Macid pole toetatud.
• Windows: Avage .appinstaller fail Windowsi rakenduste installijaga. See installib allkirjastatud MSIX-i, mis on Windowsi kasutatav rakenduspaketi tüüp.
• Linux: Töölaua installijad on mõeldud macOS-i ja Windowsi jaoks. Linuxis kasutage allolevat terminalikäsku. Pärast installimist saate käivitada hermes desktop.

Kui vajate ainult terminali

Kui kasutate Linuxit, macOS-i või WSL2-e, käivitage terminalis:

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

Windowsiga kaasasolevat PowerShelli kasutades käivitage:

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

Installija laadib alla Hermese koodi ja selle käitamiseks vajalikud programmid. Kui allalaadimine katkeb, käivitage sama käsk uuesti. Pärast installimise lõpetamist sulgege praegune terminal, avage uus aken ja sisestage:

hermes

Kui näete Hermese viipa, on käsk kasutamiseks valmis. Seejärel saate käivitada hermes doctor; see installimise kontroll ütleb teile, mis on veel puudu.

Programmi salvestamine välisele kettale

9. oktoobril 2026 installiti Hermes Agent v0.21.6 Maciga ühendatud välisele kettale. Programm salvestati asukohta /Volumes/AItools/tools/hermes-agent, käivituskäsk asus asukohas ~/.local/bin/hermes, ja konfiguratsiooni- ning vestlusandmed jäid asukohta ~/.hermes.

Kui teie kettal on teistsugune nimi, asendage tee pärast --dir oma kaustaga. Ketas peab Hermese töötamise ajal ühendatud olema.

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

Programm

Väline ketas

• tools/hermes-agent
• Hoidke koodi siin

Käsk

~/.local/bin/hermes

• Sisestage terminali hermes
• See jõustub pärast uue akna avamist

Konfiguratsioon ja vestlused

~/.hermes

• config.yaml on siin
• Välju enne ketta lahtiühendamist

Ühenduse väärtuste hankimine OmniProxyst

Siin ühendub Hermes OmniProxyle, mitte otse Grokile või Geminile. Seadistage Groki ja Gemini teenuse URL-id OmniProxys; ärge sisestage neid otse Hermesele.

Teie arvuti

Hermes

→

Kohalik lüüs

OmniProxy

• Lisage aadressile /v1

→

Grok

• grok-4.7

Gemini

• gemini-3.8-flash

Mudeli ID on täpne nimi, mida API kasutab mudeli tuvastamiseks. Kasutage kahe mudeli jaoks järgmisi nimesid:

• Groki jaoks sisestage grok-4.7. xAI API on https://api.x.ai/v1, ja vestluspäringud kasutavad /v1/chat/completions. Vaadake Groki mudeli dokumentatsiooni.
• Gemini jaoks sisestage gemini-3.8-flash. Google’i OpenAI-ga ühilduv API on https://generativelanguage.googleapis.com/v1beta/openai/. Vaadake Gemini OpenAI ühilduvuse dokumentatsiooni.

Hermese lülitamiseks Geminile muutke ainult mudeli nimi väärtuseks gemini-3.8-flash. Jätkake OmniProxy aadressi kasutamist API lõpp-punktina.

Kopeerige OmniProxyst lõpp-punkti URL ja võti, seejärel sisestage vastav mudeli ID:

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

Baas-URL on lõpp-punkt, kuhu Hermes päringuid saadab. See peab siin lõppema /v1 API-võti on võti, mille OmniProxy Hermesele väljastab. Asendage kohahoidja oma väärtusega ja ärge avaldage seda avalikul lehel.

Kui teie kohalik OmniProxy eksemplar võtit ei nõua, võite API-võtme tühjaks jätta. Kui aadress on kellelegi teisele kättesaadav, peaksite kasutama võtit. Samuti kinnitage, et aadress on kättesaadav keskkonnast, kus Hermes töötab. Kui Hermes ja OmniProxy on samas arvutis, saate kasutada kohalikku aadressi.

Tööriista seadistamine

Esmalt väljuge praegusest vestlusest, seejärel käivitage terminalis:

hermes model

Valige Custom endpoint (self-hosted / VLLM / etc.). Kohandatud lõpp-punkt tähendab, et Hermes ühendub teie määratud teenuseaadressiga, selle asemel et kasutada eelseadistatud teenusepakkujat.

Seadistusviisard küsib järjestikku lõpp-punkti URL-i, võtit ja mudeli nime. Sisestage kolm väärtust eelmisest jaotisest. Gemini kasutamiseks sisestage gemini-3.8-flash mudeli nimena.

Saate muuta ka ~/.hermes/config.yaml otse. YAML on tekstivorming, mis kasutab konfiguratsioonisuhete esitamiseks taanet. Järgmine konfiguratsioon kasutab Groki:

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

Gemini kasutamiseks muutke default väärtuseks gemini-3.8-flash ja jätke ülejäänud kolm väärtust muutmata:

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

Pärast salvestamist käivitage hermes uuesti ja alustage uut vestlust. Juba avatud seansis /model saab lülituda ainult juba salvestatud teenusepakkujate vahel; see ei saa seda konfiguratsiooni lisada.

Kontrollimine reaalse ülesandega

1

hermes doctor

• Installimise kontroll läbitud

2

Saatke lühike sõnum

• Vaadake Hermese vastust

3

Avage päringulogid

• Kontrollige mudeli nime

1. Käivitage hermes doctor et kontrollida, kas installimine on lõpetatud.
2. Käivitage hermes ja paluge sellel ühe lausega selgitada, mida see teha suudab. Peaksite nägema vastust.
3. Avage OmniProxy päringulog, kinnitage, et päring pärines Hermeselt, ja kontrollige, kas mudeli nimi on grok-4.7 või gemini-3.8-flash.

Sellest, et seadistusviisard salvestas edukalt või et API tagastas eduka vastuse, ei piisa, et näidata, et Hermes suudab teie eest ülesandeid täita. Päringulogis olev mudeli nimi peab ühtima sisestatud väärtusega.

Brauseris vestlemiseks käivitage kohapeal järgmine:

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

Seejärel avage http://127.0.0.1:9119. See aadress töötab ainult praeguses arvutis.

Levinud vead

• Sisestamine hermes teatab, et käsku ei leita: Sulgege terminal ja avage uus aken. Kui käsku ikka ei leita, kinnitage, et ~/.local/bin on PATH-is. PATH on loend kataloogidest, kust süsteem käske otsib. Windowsis kinnitage, et installija lisatud käivituskataloog on PATH-is.
• Installimise allalaadimine peatub poole pealt: Käivitage sama installimiskäsk uuesti. Juba allalaaditud osi kasutatakse uuesti.
• Hermes ei vasta või teatab, et ei saa ühendust luua: Kinnitage, et OmniProxy töötab, ja kontrollige, et baas-URL lõpeb /v1. Kui Hermes töötab Dockeris, samas kui OmniProxy töötab hostis, ärge kasutage 127.0.0.1 kui see kehtib ainult konteineri sees.
• Ilmub võtmeviga: Värskendage OmniProxy võtit, seejärel muutke api_key failis config.yaml. xAI või Google’i võti kuulub OmniProxy teenusepakkuja seadetesse; ärge sisestage seda sellesse Hermese väljale.
• Mudelist teatatakse kui kättesaamatust: Avage OmniProxys praegune mudelite loend ja kopeerige grok-4.7 või gemini-3.8-flash täpselt nii, nagu see loendis esineb.
• Hermes vastab, kuid ei saa täita ülesandeid, nagu failide lugemine või käskude täitmine: Lülituge OmniProxys teisele mudelile, millel on need võimalused, seejärel alustage uut Hermese seanssi.
• Programm on välisel kettal ja hermes doctor teatab pärast ketta lahtiühendamist salvestusveast: Ühendage ketas esmalt uuesti. Ärge laske Hermesel luua eraldi konfiguratsiooni, kui ketas on lahti ühendatud.

Viited

Installimisetappide kohta vaadake Hermese installimise dokumentatsiooni ja platvormi tuge. Kohandatud lõpp-punkti konfiguratsiooni kohta vaadake Hermese teenusepakkuja dokumentatsiooni. Mudeli ID-de kohta vaadake Groki mudeli dokumentatsiooni ja Gemini OpenAI ühilduvuse dokumentatsiooni.

macOS-i installimisprotsess viidi lõpule 2026-10-09, kasutades Hermes Agent v0.21.6. grok-4.7 ja gemini-3.8-flash olid sel kuupäeval xAI ja Google’i dokumentatsioonis standardsed mudeli ID-d. Väärtuste sisestamisel kasutage OmniProxys kuvatavaid nimesid.

Asenda iga lünk oma OmniProxy seadistuse väärtustega. Ära kunagi avalda tõelist võtit.

Salvestatud tulemus või HTTP 200 iseenesest ei tõesta täielikku Agenti ühilduvust. Vaata allikat ja mudelit OmniProxy päringukirjetes.

Ametlikud allikad · Hermes ↗