Installation af Hermes og konfiguration af OmniProxy

Hermes er en assistent, der kan bevare samtaler og opgaveerfaring, hvilket gør afsluttet arbejde til færdigheder, der kan genbruges senere. Gennem en enkelt Gateway kan den også forbindes til Telegram, Discord, Slack, WhatsApp, Signal og terminalen. Gatewayen fungerer som et samlet indgangspunkt for modtagelse og videresendelse af beskeder. Du kan sende den kodegennemgange, hændelsesnotater eller kundematerialer fra dine sædvanlige chatværktøjer og derefter få den til at vende tilbage til depotet og fortsætte arbejdet.

Før du starter

Vælg først en installationsmetode baseret på din computers operativsystem. macOS og Windows kan bruge grafiske installere direkte, mens Linux, macOS og WSL2 kan bruge et terminalscript. WSL2 er en Windows-funktion til at køre et Linux-miljø. Termux på Android-telefoner og Docker har deres egne installationsmetoder, men denne guide dækker kun installation på almindelige computere.

Vil have et vindue

macOS, Windows

• macOS: åbn DMG-filen
• Windows: åbn installeren
• Installer appen på systemet

Kun terminal

Linux, macOS, WSL2

• Én install.sh-kommando
• Brug install.ps1 på Windows
• Indtast hermes efter installation

Brug ikke disse endnu

pip, brew, AUR

• Disse installationsmetoder er ikke officielt understøttet
• De er også svære at opdatere efter installation
• Brug en af de to muligheder til venstre i stedet

Før du begynder, skal du forberede en macOS-, Windows- eller Linux-computer og sikre dig, at den kan åbne en terminal og få adgang til GitHub. Hvis du planlægger at installere Hermes på et eksternt drev, skal du tilslutte drevet først og bekræfte, at det har nok ledig plads.

Installation og første opstart

Hvis du vil have en grafisk app

Gå til download-sektionen på Hermes-webstedet og download installeren til dit operativsystem. Installeren inkluderer allerede runtime-miljøet, så intet behøver at blive kompileret lokalt, når du åbner den for første gang.

• macOS: Åbn DMG-filen og flyt Hermes.app ind i Programmer. En DMG er et installationsbillede, der almindeligvis bruges på macOS. Denne installer understøtter kun Apple silicon; Intel Macs understøttes ikke.
• Windows: Åbn .appinstaller filen med Windows App Installer. Den installerer en signeret MSIX, en type applikationspakke, der bruges af Windows.
• Linux: Desktop-installerne er til macOS og Windows. På Linux skal du bruge terminalkommandoen nedenfor. Efter installationen kan du køre hermes desktop.

Hvis du kun har brug for terminalen

Hvis du bruger Linux, macOS eller WSL2, kør dette i en terminal:

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

Når du bruger PowerShell, der følger med Windows, kør:

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

Installeren downloader Hermes-koden og de programmer, der kræves for at køre den. Hvis downloadet afbrydes, skal du køre den samme kommando igen. Når installationen er færdig, skal du lukke den aktuelle terminal, åbne et nyt vindue og indtaste:

hermes

Hvis du ser Hermes-prompten, er kommandoen klar til brug. Du kan derefter køre hermes doctor; denne installationstjek fortæller dig, hvad der stadig mangler.

Gem programmet på et eksternt drev

Den 9. oktober 2026 blev Hermes Agent v0.21.6 installeret på et eksternt drev tilsluttet en Mac. Programmet blev gemt i /Volumes/AItools/tools/hermes-agent, launcher-kommandoen var placeret i ~/.local/bin/hermes, og konfigurations- og samtaledata forblev i ~/.hermes.

Hvis dit drev har et andet navn, skal du erstatte stien efter --dir med din egen mappe. Drevet skal forblive tilsluttet, mens Hermes kø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

Eksternt drev

• tools/hermes-agent
• Hold koden her

Kommando

~/.local/bin/hermes

• Indtast hermes i terminalen
• Det træder i kraft efter åbning af et nyt vindue

Konfiguration og chats

~/.hermes

• config.yaml er her
• Afslut før drevet frakobles

Hent forbindelsesværdier fra OmniProxy

Her forbinder Hermes til OmniProxy i stedet for direkte til Grok eller Gemini. Konfigurer Grok- og Gemini-tjenesteadresser i OmniProxy; indtast dem ikke direkte i Hermes.

Din computer

Hermes

→

Lokal gateway

OmniProxy

• Inkluder /v1 i adressen

→

Grok

• grok-4.7

Gemini

• gemini-3.8-flash

Et model-ID er det nøjagtige navn, API’et bruger til at identificere en model. Brug følgende navne til de to modeller:

• For Grok, indtast grok-4.7. xAI API’et er https://api.x.ai/v1, og chat-anmodninger bruger /v1/chat/completions. Se Grok model documentation.
• For Gemini, indtast gemini-3.8-flash. Googles OpenAI-kompatible API er https://generativelanguage.googleapis.com/v1beta/openai/. Se Gemini’s OpenAI compatibility documentation.

For at skifte Hermes til Gemini, skal du kun ændre modelnavnet til gemini-3.8-flash. Fortsæt med at bruge OmniProxy-adressen som API-slutpunkt.

Kopiér slutpunkts-URL’en og nøglen fra OmniProxy, og indtast derefter det tilsvarende model-ID:

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

Base URL er det slutpunkt, som Hermes sender anmodninger til. Det skal slutte med /v1 her. API Key er den nøgle, OmniProxy udsteder til Hermes. Erstat pladsholderen med din egen værdi, og offentliggør den ikke på en offentlig side.

Hvis din lokale OmniProxy-instans ikke kræver en nøgle, kan du lade API Key være tom. Hvis adressen er tilgængelig for andre, bør du bruge en nøgle. Bekræft også, at adressen kan nås fra det miljø, hvor Hermes kører. Hvis Hermes og OmniProxy er på den samme computer, kan du bruge en lokal adresse.

Indtast værktøjskonfigurationen

Afslut først den aktuelle chat, og kør derefter dette i en terminal:

hermes model

Vælg Custom endpoint (self-hosted / VLLM / etc.). Custom endpoint betyder, at Hermes forbinder til en tjenesteadresse, du angiver, i stedet for at bruge en forudindstillet udbyder.

Opsætningsguiden beder om slutpunkts-URL, nøgle og modelnavn i rækkefølge. Indtast de tre værdier fra det forrige afsnit. For at bruge Gemini, indtast gemini-3.8-flash som modelnavn.

Du kan også redigere ~/.hermes/config.yaml direkte. YAML er et tekstformat, der bruger indrykning til at repræsentere konfigurationsrelationer. Følgende konfiguration bruger Grok:

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

For at bruge Gemini, skift default til gemini-3.8-flash og lad de andre tre værdier være uændrede:

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

Efter lagring, kør hermes igen og start en ny chat. I en allerede åben session, /model kan kun skifte mellem udbydere, der allerede er gemt; den kan ikke tilføje denne konfiguration.

Bekræft med en rigtig opgave

1

hermes doctor

• Installationstjek bestået

2

Send en kort besked

• Se et svar fra Hermes

3

Åbn anmodningslogfilerne

• Bekræft modelnavnet

1. Kør hermes doctor for at tjekke, om installationen er fuldført.
2. Kør hermes og bed den om at forklare med én sætning, hvad den kan gøre. Du bør se et svar.
3. Åbn OmniProxy-anmodningsloggen, bekræft at anmodningen kom fra Hermes, og tjek om modelnavnet er grok-4.7 eller gemini-3.8-flash.

At se, at opsætningsguiden blev gemt med succes, eller at API’et returnerede et succesfuldt svar, er ikke nok til at vise, at Hermes kan fuldføre opgaver for dig. Modelnavnet i anmodningsloggen skal matche den værdi, du indtastede.

For at chatte i en browser, kør følgende lokalt:

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

Åbn derefter http://127.0.0.1:9119. Denne adresse fungerer kun på den aktuelle computer.

Almindelige fejl

• Indtastning af hermes rapporterer, at kommandoen ikke kan findes: Luk terminalen og åbn et nyt vindue. Hvis kommandoen stadig ikke findes, bekræft at ~/.local/bin er i PATH. PATH er listen over mapper, hvor systemet leder efter kommandoer. På Windows, bekræft at launch-mappen tilføjet af installeren er i PATH.
• Installationsdownloadet stopper halvvejs: Kør den samme installationskommando igen. De dele, der allerede er downloadet, vil blive genbrugt.
• Hermes svarer ikke eller rapporterer, at den ikke kan forbinde: Bekræft at OmniProxy kører og tjek at Base URL slutter med /v1. Hvis Hermes kører i Docker, mens OmniProxy kører på værten, skal du ikke bruge 127.0.0.1 hvis den kun er gyldig inde i containeren.
• En nøglefejl vises: Opdater OmniProxy-nøglen, skift derefter api_key i config.yaml. xAI- eller Google-nøglen hører til i OmniProxy’s udbyderindstillinger; indtast den ikke i dette Hermes-felt.
• Modellen rapporteres som utilgængelig: Åbn den aktuelle modelliste i OmniProxy og kopiér grok-4.7 eller gemini-3.8-flash nøjagtigt som den vises på listen.
• Hermes svarer, men kan ikke udføre opgaver som at læse filer eller udføre kommandoer: Skift til en anden model i OmniProxy, der har disse funktioner, og start derefter en ny Hermes-session.
• Programmet er på et eksternt drev, og hermes doctor rapporterer en lagringsfejl efter drevet er frakoblet: Tilslut drevet igen. Lad ikke Hermes oprette en separat konfiguration, mens drevet er frakoblet.

Referencer

For installationstrin, se Hermes installation documentation og platform support. For Custom endpoint-konfiguration, se Hermes Provider documentation. For model-ID’erne, se Grok model documentation og Gemini’s OpenAI compatibility documentation.

macOS-installationsprocessen blev fuldført den 2026-10-09 ved hjælp af Hermes Agent v0.21.6. grok-4.7 og gemini-3.8-flash var standardmodel-ID’erne i xAI- og Google-dokumentationen på den dato. Når du indtaster værdierne, skal du bruge navnene vist i OmniProxy.

Erstat alle pladsholdere med værdier fra din egen OmniProxy-konfiguration. Publicér aldrig en rigtig nøgle.

Et gemt resultat eller HTTP 200 alene beviser ikke fuld agentkompatibilitet. Tjek kilden og modellen i OmniProxys anmodningspost.

Officielle kilder · Hermes ↗