Installere Hermes og konfigurere OmniProxy

Hermes er en assistent som kan beholde samtaler og oppgaveerfaring, og gjøre fullført arbeid til ferdigheter som kan gjenbrukes senere. Gjennom én enkelt Gateway kan den også koble til Telegram, Discord, Slack, WhatsApp, Signal og terminalen. Gatewayen fungerer som et enhetlig inngangspunkt for å motta og videresende meldinger. Du kan sende den kodegjennomganger, hendelsesnotater eller kundemateriell fra dine vanlige chat-verktøy, og deretter få den til å gå tilbake til depotet og fortsette arbeidet.

Før du starter

Velg først en installasjonsmetode basert på datamaskinens operativsystem. macOS og Windows kan bruke grafiske installasjonsprogrammer direkte, mens Linux, macOS og WSL2 kan bruke et terminalskript. WSL2 er en Windows-funksjon for å kjøre et Linux-miljø. Termux på Android-telefoner og Docker har sine egne installasjonsmetoder, men denne guiden dekker kun installasjon på vanlige datamaskiner.

Vil ha et vindu

macOS, Windows

• macOS: åpne DMG-filen
• Windows: åpne installasjonsprogrammet
• Installer appen på systemet

Kun terminal

Linux, macOS, WSL2

• Én install.sh-kommando
• Bruk install.ps1 på Windows
• Skriv inn hermes etter installasjon

Ikke bruk disse ennå

pip, brew, AUR

• Disse installasjonsmetodene støttes ikke offisielt
• De er også vanskelige å oppdatere etter installasjon
• Bruk ett av de to alternativene til venstre i stedet

Før du begynner, klargjør en macOS-, Windows- eller Linux-datamaskin og sørg for at den kan åpne en terminal og få tilgang til GitHub. Hvis du planlegger å installere Hermes på en ekstern stasjon, koble til stasjonen først og bekreft at den har nok ledig plass.

Installer og start for første gang

Hvis du vil ha en grafisk app

Gå til nedlastingsdelen på Hermes-nettstedet og last ned installasjonsprogrammet for operativsystemet ditt. Installasjonsprogrammet inkluderer allerede kjøretidsmiljøet, så ingenting trenger å kompileres lokalt når du åpner det for første gang.

• macOS: Åpne DMG-filen og flytt Hermes.app inn i Programmer. En DMG er et installasjonsbilde som ofte brukes på macOS. Dette installasjonsprogrammet støtter kun Apple Silicon; Intel-Macer støttes ikke.
• Windows: Åpne .appinstaller filen med Windows App Installer. Den installerer en signert MSIX, en type applikasjonspakke som brukes av Windows.
• Linux: Skrivebordsinstallasjonsprogrammene er for macOS og Windows. På Linux, bruk terminalkommandoen nedenfor. Etter installasjon kan du kjøre hermes desktop.

Hvis du bare trenger terminalen

Hvis du bruker Linux, macOS eller WSL2, kjør dette i en terminal:

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

Når du bruker PowerShell som følger med Windows, kjør:

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

Installasjonsprogrammet laster ned Hermes-koden og programmene som kreves for å kjøre den. Hvis nedlastingen blir avbrutt, kjør den samme kommandoen igjen. Etter at installasjonen er fullført, lukk den gjeldende terminalen, åpne et nytt vindu og skriv inn:

hermes

Hvis du ser Hermes-ledeteksten, er kommandoen klar til bruk. Du kan deretter kjøre hermes doctor; denne installasjonssjekken forteller deg hva som fortsatt mangler.

Lagre programmet på en ekstern stasjon

Den 09.10.2026 ble Hermes Agent v0.21.6 installert på en ekstern stasjon koblet til en Mac. Programmet ble lagret på /Volumes/AItools/tools/hermes-agent, startkommandoen var plassert på ~/.local/bin/hermes, og konfigurasjons- og samtaledata forble i ~/.hermes.

Hvis stasjonen din har et annet navn, erstatt banen etter --dir med din egen mappe. Stasjonen må forbli tilkoblet mens Hermes kjører.

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

Program

Ekstern stasjon

• tools/hermes-agent
• Oppbevar koden her

Kommando

~/.local/bin/hermes

• Skriv inn hermes i terminalen
• Det trer i kraft etter åpning av et nytt vindu

Konfigurasjon og chatter

~/.hermes

• config.yaml er her
• Avslutt før du kobler fra stasjonen

Hent tilkoblingsverdier fra OmniProxy

Her kobler Hermes til OmniProxy i stedet for direkte til Grok eller Gemini. Konfigurer Grok- og Gemini-tjenesteadressene i OmniProxy; ikke skriv dem inn direkte i Hermes.

Datamaskinen din

Hermes

→

Lokal gateway

OmniProxy

• Inkluder /v1 i adressen

→

Grok

• grok-4.7

Gemini

• gemini-3.8-flash

En modell-ID er det nøyaktige navnet API-et bruker for å identifisere en modell. Bruk følgende navn for de to modellene:

• For Grok, skriv inn grok-4.7. xAI API-et er https://api.x.ai/v1, og chat-forespørsler bruker /v1/chat/completions. Se Grok-modelldokumentasjonen.
• For Gemini, skriv inn gemini-3.8-flash. Googles OpenAI-kompatible API er https://generativelanguage.googleapis.com/v1beta/openai/. Se Geminis OpenAI-kompatibilitetsdokumentasjon.

For å bytte Hermes til Gemini, endre bare modellnavnet til gemini-3.8-flash. Fortsett å bruke OmniProxy-adressen som API-endepunkt.

Kopier endepunkt-URL-en og nøkkelen fra OmniProxy, og skriv deretter inn den tilsvarende modell-ID-en:

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

Base URL er endepunktet som Hermes sender forespørsler til. Den må slutte med /v1 her. API Key er nøkkelen OmniProxy utsteder til Hermes. Erstatt plassholderen med din egen verdi, og ikke publiser den på en offentlig side.

Hvis din lokale OmniProxy-instans ikke krever en nøkkel, kan du la API Key være tom. Hvis adressen er tilgjengelig for andre, bør du bruke en nøkkel. Bekreft også at adressen er tilgjengelig fra miljøet der Hermes kjører. Hvis Hermes og OmniProxy er på samme datamaskin, kan du bruke en lokal adresse.

Angi verktøykonfigurasjon

Avslutt først den gjeldende chatten, og kjør deretter dette i en terminal:

hermes model

Velg Custom endpoint (self-hosted / VLLM / etc.). Custom endpoint betyr at Hermes kobler til en tjenesteadresse du spesifiserer i stedet for å bruke en forhåndsinnstilt leverandør.

Oppsettveiviseren ber om endepunkt-URL, nøkkel og modellnavn i rekkefølge. Skriv inn de tre verdiene fra forrige del. For å bruke Gemini, skriv inn gemini-3.8-flash som modellnavn.

Du kan også redigere ~/.hermes/config.yaml direkte. YAML er et tekstformat som bruker innrykk for å representere konfigurasjonsforhold. Følgende konfigurasjon bruker Grok:

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

For å bruke Gemini, endre default til gemini-3.8-flash og la de tre andre verdiene være uendret:

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

Etter lagring, kjør hermes igjen og start en ny chat. I en allerede åpen økt, /model kan bare bytte mellom leverandører som allerede er lagret; den kan ikke legge til denne konfigurasjonen.

Bekreft med en ekte oppgave

1

hermes doctor

• Installasjonssjekk bestått

2

Send en kort melding

• Se et svar fra Hermes

3

Åpne forespørselsloggene

• Bekreft modellnavnet

1. Kjør hermes doctor for å sjekke om installasjonen er fullført.
2. Kjør hermes og be den forklare med én setning hva den kan gjøre. Du bør se et svar.
3. Åpne OmniProxy-forespørselsloggen, bekreft at forespørselen kom fra Hermes, og sjekk om modellnavnet er grok-4.7 eller gemini-3.8-flash.

Å se at oppsettveiviseren ble lagret, eller at API-et returnerte et vellykket svar, er ikke nok til å vise at Hermes kan fullføre oppgaver for deg. Modellnavnet i forespørselsloggen må samsvare med verdien du skrev inn.

For å chatte i en nettleser, kjør følgende lokalt:

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

Åpne deretter http://127.0.0.1:9119. Denne adressen fungerer kun på den gjeldende datamaskinen.

Vanlige feil

• Å skrive inn hermes rapporterer at kommandoen ikke finnes: Lukk terminalen og åpne et nytt vindu. Hvis kommandoen fortsatt ikke finnes, bekreft at ~/.local/bin er i PATH. PATH er listen over kataloger der systemet ser etter kommandoer. På Windows, bekreft at startkatalogen som ble lagt til av installasjonsprogrammet, er i PATH.
• Installasjonsnedlastingen stopper halvveis: Kjør den samme installasjonskommandoen igjen. Delene som allerede er lastet ned, vil bli gjenbrukt.
• Hermes svarer ikke eller rapporterer at den ikke kan koble til: Bekreft at OmniProxy kjører og sjekk at Base URL slutter med /v1. Hvis Hermes kjører i Docker mens OmniProxy kjører på verten, ikke bruk 127.0.0.1 hvis den kun er gyldig inne i beholderen.
• En nøkkelfeil vises: Oppdater OmniProxy-nøkkelen, og endre deretter api_key i config.yaml. xAI- eller Google-nøkkelen hører hjemme i OmniProxys leverandørinnstillinger; ikke skriv den inn i dette Hermes-feltet.
• Modellen rapporteres som utilgjengelig: Åpne den gjeldende modellisten i OmniProxy og kopier grok-4.7 eller gemini-3.8-flash nøyaktig slik den vises i listen.
• Hermes svarer, men kan ikke utføre oppgaver som å lese filer eller utføre kommandoer: Bytt til en annen modell i OmniProxy som har disse egenskapene, og start deretter en ny Hermes-økt.
• Programmet er på en ekstern stasjon, og hermes doctor rapporterer en lagringsfeil etter at stasjonen er koblet fra: Koble til stasjonen først. Ikke la Hermes opprette en separat konfigurasjon mens stasjonen er koblet fra.

Referanser

For installasjonstrinn, se Hermes-installasjonsdokumentasjonen og plattformstøtte. For konfigurasjon av Custom endpoint, se Hermes Provider-dokumentasjonen. For modell-ID-ene, se Grok-modelldokumentasjonen og Geminis OpenAI-kompatibilitetsdokumentasjon.

macOS-installasjonsprosessen ble fullført 09.10.2026 ved bruk av Hermes Agent v0.21.6. grok-4.7 og gemini-3.8-flash var standard modell-ID-er i xAI- og Google-dokumentasjonen på den datoen. Når du skriver inn verdiene, bruk navnene som vises i OmniProxy.

Erstatt alle plassholdere med verdier fra din egen OmniProxy-konfigurasjon. Publisér aldri en ekte nøkkel.

Et lagret resultat eller HTTP 200 alene beviser ikke full kompatibilitet med en agent. Sjekk kilde og modell i OmniProxy sin kalllogg.

Offisielle kilder · Hermes ↗