Hermesin asennus ja OmniProxyn määrittäminen

Hermes on avustaja, joka voi säilyttää keskustelut ja tehtäväkokemuksen, muuttaen valmistuneen työn taidoiksi, joita voidaan käyttää myöhemmin. Yhden yhdyskäytävän (Gateway) kautta se voi myös yhdistää Telegramiin, Discordiin, Slackiin, WhatsAppiin, Signaliin ja päätteeseen. Yhdyskäytävä toimii yhtenäisenä sisääntulopisteenä viestien vastaanottamiseen ja välittämiseen. Voit lähettää sille koodikatselmuksia, tapahtumamuistiinpanoja tai asiakasmateriaaleja tavallisista chat-työkaluistasi ja saada sen palaamaan arkistoon ja jatkamaan työskentelyä.

Ennen kuin aloitat

Valitse ensin asennustapa tietokoneesi käyttöjärjestelmän perusteella. macOS ja Windows voivat käyttää graafisia asennusohjelmia suoraan, kun taas Linux, macOS ja WSL2 voivat käyttää pääteskriptiä. WSL2 on Windows-ominaisuus Linux-ympäristön ajamiseen. Android-puhelimien Termuxilla ja Dockerilla on omat asennustapansa, mutta tämä opas kattaa vain asennuksen tavallisille tietokoneille.

Haluat ikkunan

macOS, Windows

• macOS: avaa DMG
• Windows: avaa asennusohjelma
• Asenna sovellus järjestelmään

Vain pääte

Linux, macOS, WSL2

• Yksi install.sh-komento
• Käytä install.ps1-tiedostoa Windowsilla
• Syötä hermes asennuksen jälkeen

Älä käytä näitä vielä

pip, brew, AUR

• Näitä asennustapoja ei tueta virallisesti
• Niitä on myös vaikea päivittää asennuksen jälkeen
• Käytä sen sijaan yhtä vasemmalla olevista vaihtoehdoista

Ennen aloittamista, valmistele macOS-, Windows- tai Linux-tietokone ja varmista, että voit avata päätteen ja käyttää GitHubia. Jos aiot asentaa Hermeksen ulkoiselle levylle, yhdistä levy ensin ja varmista, että siinä on tarpeeksi vapaata tilaa.

Asennus ja ensimmäinen käynnistys

Jos haluat graafisen sovelluksen

Siirry Hermes-sivuston latausosioon ja lataa asennusohjelma käyttöjärjestelmällesi. Asennusohjelma sisältää jo suoritusympäristön, joten mitään ei tarvitse kääntää paikallisesti, kun avaat sen ensimmäistä kertaa.

• macOS: Avaa DMG ja siirrä Hermes.app Sovellukset-kansioon. DMG on macOS:llä yleisesti käytetty asennuskuva. Tämä asennusohjelma tukee vain Apple Siliconia; Intel-Macit eivät ole tuettuja.
• Windows: Avaa .appinstaller tiedosto Windowsin sovellusten asennusohjelmalla. Se asentaa allekirjoitetun MSIX-paketin, joka on Windowsin käyttämä sovelluspakettityyppi.
• Linux: Työpöytäasennusohjelmat ovat macOS:lle ja Windowsille. Käytä Linuxilla alla olevaa päätekomentoa. Asennuksen jälkeen voit suorittaa hermes desktop.

Jos tarvitset vain päätteen

Jos käytät Linuxia, macOS:ää tai WSL2:ta, suorita tämä päätteessä:

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

Kun käytät Windowsin mukana tulevaa PowerShelliä, suorita:

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

Asennusohjelma lataa Hermeksen koodin ja sen ajamiseen tarvittavat ohjelmat. Jos lataus keskeytyy, suorita sama komento uudelleen. Kun asennus on valmis, sulje nykyinen pääte, avaa uusi ikkuna ja syötä:

hermes

Jos näet Hermes-kehotteen, komento on käyttövalmis. Voit sitten suorittaa hermes doctor; tämä asennustarkistus kertoo, mitä vielä puuttuu.

Ohjelman tallentaminen ulkoiselle levylle

9. lokakuuta 2026 Hermes Agent v0.21.6 asennettiin Maciin yhdistetylle ulkoiselle levylle. Ohjelma tallennettiin hakemistoon /Volumes/AItools/tools/hermes-agent, käynnistyskomento sijaitsi kohdassa ~/.local/bin/hermes, ja määritys- sekä keskustelutiedot pysyivät kohdassa ~/.hermes.

Jos levylläsi on eri nimi, korvaa polku kohdan --dir jälkeen omalla kansiolla. Levyn on pysyttävä yhdistettynä Hermeksen ollessa käynnissä.

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

Ohjelma

Ulkoinen levy

• tools/hermes-agent
• Pidä koodi täällä

Komento

~/.local/bin/hermes

• Syötä hermes päätteeseen
• Tulee voimaan uuden ikkunan avaamisen jälkeen

Määritykset ja keskustelut

~/.hermes

• config.yaml on täällä
• Poistu ennen levyn irrottamista

Hae yhteysarvot OmniProxysta

Tässä Hermes yhdistää OmniProxyyn eikä suoraan Grokiin tai Geminiin. Määritä Grok- ja Gemini-palveluosoitteet OmniProxyssa; älä syötä niitä suoraan Hermekseen.

Tietokoneesi

Hermes

→

Paikallinen yhdyskäytävä

OmniProxy

• Sisällytä /v1 osoitteeseen

→

Grok

• grok-4.7

Gemini

• gemini-3.8-flash

Mallitunnus on tarkka nimi, jota API käyttää mallin yksilöimiseen. Käytä näille kahdelle mallille seuraavia nimiä:

• Grokille, syötä grok-4.7. xAI API on https://api.x.ai/v1, ja chat-pyynnöt käyttävät /v1/chat/completions. Katso Grok-mallidokumentaatio.
• Geminille, syötä gemini-3.8-flash. Googlen OpenAI-yhteensopiva API on https://generativelanguage.googleapis.com/v1beta/openai/. Katso Geminin OpenAI-yhteensopivuusdokumentaatio.

Vaihtaaksesi Hermeksen Geminiin, muuta vain mallin nimi muotoon gemini-3.8-flash. Jatka OmniProxy-osoitteen käyttöä API-päätepisteenä.

Kopioi päätepisteen URL ja avain OmniProxysta, syötä sitten vastaava mallitunnus:

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

Base URL on päätepiste, johon Hermes lähettää pyynnöt. Sen on päätyttävä tässä kohtaa /v1 . API Key on avain, jonka OmniProxy myöntää Hermekselle. Korvaa paikkamerkki omalla arvollasi, äläkä julkaise sitä julkisella sivulla.

Jos paikallinen OmniProxy-instanssisi ei vaadi avainta, voit jättää API Keyn tyhjäksi. Jos osoite on kenen tahansa käytettävissä, sinun tulee käyttää avainta. Varmista myös, että osoite on tavoitettavissa ympäristöstä, jossa Hermes toimii. Jos Hermes ja OmniProxy ovat samalla tietokoneella, voit käyttää paikallista osoitetta.

Syötä työkalun määritykset

Poistu ensin nykyisestä chatista ja suorita sitten tämä päätteessä:

hermes model

Valitse Custom endpoint (self-hosted / VLLM / etc.). Custom endpoint tarkoittaa, että Hermes yhdistää määrittämääsi palveluosoitteeseen esiasetetun palveluntarjoajan sijaan.

Määritysohjattu toiminto kysyy päätepisteen URL-osoitetta, avainta ja mallin nimeä järjestyksessä. Syötä kolme arvoa edellisestä osiosta. Käyttääksesi Geminiä, syötä gemini-3.8-flash mallin nimeksi.

Voit myös muokata tiedostoa ~/.hermes/config.yaml suoraan. YAML on tekstimuoto, joka käyttää sisennystä määrityssuhteiden esittämiseen. Seuraava määritys käyttää Grokia:

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

Käyttääksesi Geminiä, muuta default muotoon gemini-3.8-flash ja jätä muut kolme arvoa ennalleen:

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

Tallennuksen jälkeen suorita hermes uudelleen ja aloita uusi chat. Jo avatussa istunnossa /model voi vaihtaa vain jo tallennettujen palveluntarjoajien välillä; se ei voi lisätä tätä määritystä.

Vahvista todellisella tehtävällä

1

hermes doctor

• Asennustarkistus läpäisty

2

Lähetä lyhyt viesti

• Näe vastaus Hermekseltä

3

Avaa pyyntölokit

• Vahvista mallin nimi

1. Suorita hermes doctor tarkistaaksesi, onko asennus valmis.
2. Suorita hermes ja pyydä sitä selittämään yhdellä lauseella, mitä se voi tehdä. Sinun pitäisi nähdä vastaus.
3. Avaa OmniProxyn pyyntöloki, vahvista, että pyyntö tuli Hermekseltä, ja tarkista, onko mallin nimi grok-4.7 tai gemini-3.8-flash.

Se, että määritysohjattu toiminto tallensi onnistuneesti tai että API palautti onnistuneen vastauksen, ei riitä osoittamaan, että Hermes voi suorittaa tehtäviä puolestasi. Pyyntölokin mallin nimen on täsmättävä syöttämääsi arvoon.

Chattaillaksesi selaimessa, suorita paikallisesti seuraava:

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

Avaa sitten http://127.0.0.1:9119. Tämä osoite toimii vain nykyisellä tietokoneella.

Yleiset virheet

• Syöttäminen hermes raportoi, ettei komentoa löydy: Sulje pääte ja avaa uusi ikkuna. Jos komentoa ei vieläkään löydy, varmista, että ~/.local/bin on PATH-muuttujassa. PATH on luettelo hakemistoista, joista järjestelmä etsii komentoja. Varmista Windowsilla, että asennusohjelman lisäämä käynnistyshakemisto on PATH-muuttujassa.
• Asennuksen lataus pysähtyy kesken: Suorita sama asennuskomento uudelleen. Jo ladattuja osia käytetään uudelleen.
• Hermes ei vastaa tai raportoi, ettei voi yhdistää: Varmista, että OmniProxy on käynnissä, ja tarkista, että Base URL päättyy /v1. Jos Hermes toimii Dockerissa, kun taas OmniProxy toimii isäntäkoneella, älä käytä 127.0.0.1 jos se on voimassa vain kontin sisällä.
• Avainvirhe ilmestyy: Päivitä OmniProxy-avain, muuta sitten api_key kohdassa config.yaml. xAI- tai Google-avain kuuluu OmniProxyn palveluntarjoajan asetuksiin; älä syötä sitä tähän Hermeksen kenttään.
• Mallin raportoidaan olevan poissa käytöstä: Avaa nykyinen mallilista OmniProxyssa ja kopioi grok-4.7 tai gemini-3.8-flash täsmälleen sellaisena kuin se näkyy listassa.
• Hermes vastaa, mutta ei voi suorittaa tehtäviä, kuten tiedostojen lukemista tai komentojen suorittamista: Vaihda toiseen malliin OmniProxyssa, jolla on kyseiset ominaisuudet, ja aloita sitten uusi Hermes-istunto.
• Ohjelma on ulkoisella levyllä, ja hermes doctor raportoi tallennusvirheen levyn irrottamisen jälkeen: Yhdistä levy ensin. Älä anna Hermeksen luoda erillistä määritystä levyn ollessa irrotettuna.

Viitteet

Katso asennusvaiheet Hermes-asennusdokumentaatiosta ja alustatuesta. Katso Custom endpoint -määritys Hermes Provider -dokumentaatiosta. Katso mallitunnukset Grok-mallidokumentaatiosta ja Geminin OpenAI-yhteensopivuusdokumentaatiosta.

macOS-asennusprosessi suoritettiin 9. lokakuuta 2026 käyttäen Hermes Agent v0.21.6-versiota. grok-4.7 ja gemini-3.8-flash olivat vakiomallitunnukset xAI- ja Google-dokumentaatiossa kyseisenä päivänä. Kun syötät arvoja, käytä OmniProxyssa näkyviä nimiä.

Korvaa jokainen paikanpitäjä arvoilla omasta OmniProxy-konfiguraatiostasi. Älä koskaan julkaise todellista avainta.

Tallennettu tulos tai HTTP 200 -vastaus ei yksinään todista täydellistä Agent-yhteensopivuutta. Tarkista lähde ja malli OmniProxyn kutsulogista.

Viralliset lähteet · Hermes ↗