Installera Hermes och konfigurera OmniProxy

Hermes är en assistent som kan behålla konversationer och uppgiftserfarenhet, vilket förvandlar slutfört arbete till färdigheter som kan återanvändas senare. Genom en enda Gateway kan den också ansluta till Telegram, Discord, Slack, WhatsApp, Signal och terminalen. Gatewayen fungerar som en enhetlig ingångspunkt för att ta emot och vidarebefordra meddelanden. Du kan skicka kodgranskningar, incidentanteckningar eller kundmaterial från dina vanliga chattverktyg, och sedan låta den återvända till arkivet och fortsätta arbeta.

Innan du börjar

Välj först en installationsmetod baserat på din dators operativsystem. macOS och Windows kan använda grafiska installationsprogram direkt, medan Linux, macOS och WSL2 kan använda ett terminalskript. WSL2 är en Windows-funktion för att köra en Linux-miljö. Termux på Android-telefoner och Docker har sina egna installationsmetoder, men denna guide täcker endast installation på vanliga datorer.

Vill ha ett fönster

macOS, Windows

• macOS: öppna DMG-filen
• Windows: öppna installationsprogrammet
• Installera appen på systemet

Endast terminal

Linux, macOS, WSL2

• Ett install.sh-kommando
• Använd install.ps1 på Windows
• Ange hermes efter installationen

Använd inte dessa än

pip, brew, AUR

• Dessa installationsmetoder stöds inte officiellt
• De är också svåra att uppdatera efter installationen
• Använd ett av de två alternativen till vänster istället

Innan du börjar, förbered en macOS-, Windows- eller Linux-dator och se till att den kan öppna en terminal och komma åt GitHub. Om du planerar att installera Hermes på en extern enhet, anslut enheten först och bekräfta att den har tillräckligt med ledigt utrymme.

Installation och första start

Om du vill ha en grafisk app

Gå till nedladdningsavsnittet på Hermes webbplats och ladda ner installationsprogrammet för ditt operativsystem. Installationsprogrammet inkluderar redan körtidsmiljön, så inget behöver kompileras lokalt när du öppnar det för första gången.

• macOS: Öppna DMG-filen och flytta Hermes.app till Program. En DMG är en installationsavbildning som ofta används på macOS. Detta installationsprogram stöder endast Apple silicon; Intel-Macar stöds inte.
• Windows: Öppna .appinstaller-filen med Windows App Installer. Den installerar en signerad MSIX, en typ av applikationspaket som används av Windows.
• Linux: Skrivbordsinstallationsprogrammen är för macOS och Windows. På Linux, använd terminalkommandot nedan. Efter installationen kan du köra hermes desktop.

Om du bara behöver terminalen

Om du använder Linux, macOS eller WSL2, kör detta i en terminal:

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

När du använder PowerShell som ingår i Windows, kör:

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

Installationsprogrammet laddar ner Hermes-koden och de program som krävs för att köra den. Om nedladdningen avbryts, kör samma kommando igen. När installationen är klar, stäng den aktuella terminalen, öppna ett nytt fönster och ange:

hermes

Om du ser Hermes-prompten är kommandot redo att användas. Du kan sedan köra hermes doctor; denna installationskontroll talar om för dig vad som fortfarande saknas.

Lagra programmet på en extern enhet

Den 9 oktober 2026 installerades Hermes Agent v0.21.6 på en extern enhet ansluten till en Mac. Programmet lagrades på /Volumes/AItools/tools/hermes-agent, startkommandot fanns på ~/.local/bin/hermes, och konfigurations- och konversationsdata förblev i ~/.hermes.

Om din enhet har ett annat namn, ersätt sökvägen efter --dir med din egen mapp. Enheten måste förbli ansluten medan Hermes körs.

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

Program

Extern enhet

• tools/hermes-agent
• Behåll koden här

Kommando

~/.local/bin/hermes

• Ange hermes i terminalen
• Det träder i kraft efter att ha öppnat ett nytt fönster

Konfiguration och chattar

~/.hermes

• config.yaml finns här
• Avsluta innan du kopplar från enheten

Hämta anslutningsvärden från OmniProxy

Här ansluter Hermes till OmniProxy istället för direkt till Grok eller Gemini. Konfigurera Grok- och Gemini-tjänstadresserna i OmniProxy; ange dem inte direkt i Hermes.

Din dator

Hermes

→

Lokal gateway

OmniProxy

• Inkludera /v1 i adressen

→

Grok

• grok-4.7

Gemini

• gemini-3.8-flash

Ett modell-ID är det exakta namnet som API:et använder för att identifiera en modell. Använd följande namn för de två modellerna:

• För Grok, ange grok-4.7. xAI API är https://api.x.ai/v1, och chattbegäranden använder /v1/chat/completions. Se Grok model documentation.
• För Gemini, ange gemini-3.8-flash. Googles OpenAI-kompatibla API är https://generativelanguage.googleapis.com/v1beta/openai/. Se Gemini’s OpenAI compatibility documentation.

För att växla Hermes till Gemini, ändra endast modellnamnet till gemini-3.8-flash. Fortsätt använda OmniProxy-adressen som API-slutpunkt.

Kopiera slutpunkts-URL:en och nyckeln från OmniProxy, ange sedan motsvarande modell-ID:

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

Base URL är slutpunkten som Hermes skickar begäranden till. Den måste sluta med /v1 här. API Key är nyckeln som OmniProxy utfärdar till Hermes. Ersätt platshållaren med ditt eget värde och publicera den inte på en offentlig sida.

Om din lokala OmniProxy-instans inte kräver en nyckel kan du lämna API Key tom. Om adressen är tillgänglig för någon annan bör du använda en nyckel. Bekräfta också att adressen är nåbar från miljön där Hermes körs. Om Hermes och OmniProxy finns på samma dator kan du använda en lokal adress.

Ange verktygskonfigurationen

Avsluta först den aktuella chatten, kör sedan detta i en terminal:

hermes model

Välj Custom endpoint (self-hosted / VLLM / etc.). Custom endpoint innebär att Hermes ansluter till en tjänstadress du anger istället för att använda en förinställd leverantör.

Konfigurationsguiden frågar efter slutpunkts-URL, nyckel och modellnamn i ordning. Ange de tre värdena från föregående avsnitt. För att använda Gemini, ange gemini-3.8-flash som modellnamn.

Du kan även redigera ~/.hermes/config.yaml direkt. YAML är ett textformat som använder indrag för att representera konfigurationsrelationer. Följande konfiguration använder Grok:

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

För att använda Gemini, ändra default till gemini-3.8-flash och lämna de andra tre värdena oförändrade:

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

Efter att ha sparat, kör hermes igen och starta en ny chatt. I en redan öppen session kan /model endast växla mellan leverantörer som redan har sparats; den kan inte lägga till denna konfiguration.

Verifiera med en verklig uppgift

1

hermes doctor

• Installationskontrollen godkänd

2

Skicka ett kort meddelande

• Se ett svar från Hermes

3

Öppna begärandeloggarna

• Verifiera modellnamnet

1. Kör hermes doctor för att kontrollera om installationen är slutförd.
2. Kör hermes och be den förklara i en mening vad den kan göra. Du bör se ett svar.
3. Öppna OmniProxy-begärandeloggen, bekräfta att begäran kom från Hermes och kontrollera om modellnamnet är grok-4.7 eller gemini-3.8-flash.

Att se att konfigurationsguiden sparades framgångsrikt, eller att API:et returnerade ett lyckat svar, räcker inte för att visa att Hermes kan slutföra uppgifter åt dig. Modellnamnet i begärandeloggen måste matcha värdet du angav.

För att chatta i en webbläsare, kör följande lokalt:

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

Öppna sedan http://127.0.0.1:9119. Denna adress fungerar endast på den aktuella datorn.

Vanliga fel

• Att ange hermes rapporterar att kommandot inte kan hittas: Stäng terminalen och öppna ett nytt fönster. Om kommandot fortfarande inte hittas, bekräfta att ~/.local/bin finns i PATH. PATH är listan över kataloger där systemet letar efter kommandon. På Windows, bekräfta att startkatalogen som lades till av installationsprogrammet finns i PATH.
• Installationsnedladdningen stannar halvvägs: Kör samma installationskommando igen. De delar som redan laddats ner kommer att återanvändas.
• Hermes svarar inte eller rapporterar att den inte kan ansluta: Bekräfta att OmniProxy körs och kontrollera att Base URL slutar med /v1. Om Hermes körs i Docker medan OmniProxy körs på värden, använd inte 127.0.0.1 om den endast är giltig inuti containern.
• Ett nyckelfel visas: Uppdatera OmniProxy-nyckeln, ändra sedan api_key i config.yaml. xAI- eller Google-nyckeln hör hemma i OmniProxys leverantörsinställningar; ange den inte i detta Hermes-fält.
• Modellen rapporteras som otillgänglig: Öppna den aktuella modellistan i OmniProxy och kopiera grok-4.7 eller gemini-3.8-flash exakt som den visas i listan.
• Hermes svarar men kan inte utföra uppgifter som att läsa filer eller köra kommandon: Växla till en annan modell i OmniProxy som har dessa funktioner, starta sedan en ny Hermes-session.
• Programmet finns på en extern enhet, och hermes doctor rapporterar ett lagringsfel efter att enheten kopplats från: Anslut enheten först. Låt inte Hermes skapa en separat konfiguration medan enheten är frånkopplad.

Referenser

För installationssteg, se Hermes installation documentation och platform support. För konfiguration av Custom endpoint, se Hermes Provider documentation. För modell-ID:n, se Grok model documentation och Gemini’s OpenAI compatibility documentation.

Installationsprocessen för macOS slutfördes den 2026-10-09 med Hermes Agent v0.21.6. grok-4.7 och gemini-3.8-flash var standardmodell-ID:n i xAI- och Google-dokumentationen det datumet. När du anger värdena, använd namnen som visas i OmniProxy.

Ersätt varje platshållare med värden från din egen OmniProxy-konfiguration. Publicera aldrig en riktig nyckel.

Ett sparat resultat eller HTTP 200 ensamt bevisar inte fullständig agentkompatibilitet. Kontrollera källa och modell i OmniProxys anropslogg.

Officiella källor · Hermes ↗