Hermes installeren en OmniProxy configureren

Hermes is een assistent die gesprekken en taakervaring kan behouden, waardoor voltooid werk wordt omgezet in vaardigheden die later opnieuw kunnen worden gebruikt. Via één Gateway kan het ook verbinding maken met Telegram, Discord, Slack, WhatsApp, Signal en de terminal. De Gateway fungeert als een uniform toegangspunt voor het ontvangen en doorsturen van berichten. Je kunt het codebeoordelingen, incidentnotities of klantmateriaal sturen vanuit je gebruikelijke chattools en het vervolgens laten terugkeren naar de repository om verder te werken.

Voordat je begint

Kies eerst een installatiemethode op basis van het besturingssysteem van je computer. macOS en Windows kunnen direct grafische installatieprogramma’s gebruiken, terwijl Linux, macOS en WSL2 een terminalscript kunnen gebruiken. WSL2 is een Windows-functie voor het draaien van een Linux-omgeving. Termux op Android-telefoons en Docker hebben hun eigen installatiemethoden, maar deze gids behandelt alleen de installatie op gewone computers.

Wil je een venster

macOS, Windows

• macOS: open de DMG
• Windows: open het installatieprogramma
• Installeer de app op het systeem

Alleen terminal

Linux, macOS, WSL2

• Eén install.sh opdracht
• Gebruik install.ps1 op Windows
• Voer hermes in na installatie

Gebruik deze nog niet

pip, brew, AUR

• Deze installatiemethoden worden niet officieel ondersteund
• Ze zijn ook moeilijk bij te werken na installatie
• Gebruik in plaats daarvan een van de twee opties aan de linkerkant

Bereid voordat je begint een macOS-, Windows- of Linux-computer voor en zorg ervoor dat deze een terminal kan openen en toegang heeft tot GitHub. Als je van plan bent Hermes op een externe schijf te installeren, sluit de schijf dan eerst aan en bevestig dat er voldoende vrije ruimte is.

Installeren en voor de eerste keer opstarten

Als je een grafische app wilt

Ga naar het downloadgedeelte op de Hermes-website en download het installatieprogramma voor jouw besturingssysteem. Het installatieprogramma bevat al de runtime-omgeving, dus er hoeft niets lokaal te worden gecompileerd wanneer je het voor de eerste keer opent.

• macOS: Open de DMG en verplaats Hermes.app naar Programma’s. Een DMG is een installatie-image die veel wordt gebruikt op macOS. Dit installatieprogramma ondersteunt alleen Apple silicon; Intel Macs worden niet ondersteund.
• Windows: Open het .appinstaller bestand met Windows App Installer. Het installeert een ondertekende MSIX, een type applicatiepakket dat door Windows wordt gebruikt.
• Linux: De desktop-installatieprogramma’s zijn voor macOS en Windows. Gebruik op Linux de onderstaande terminalopdracht. Na installatie kun je hermes desktopuitvoeren.

Als je alleen de terminal nodig hebt

Als je Linux, macOS of WSL2 gebruikt, voer dit dan uit in een terminal:

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

Voer bij gebruik van de PowerShell in Windows het volgende uit:

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

Het installatieprogramma downloadt de Hermes-code en de programma’s die nodig zijn om deze uit te voeren. Als de download wordt onderbroken, voer dan dezelfde opdracht opnieuw uit. Sluit na voltooiing van de installatie de huidige terminal, open een nieuw venster en voer het volgende in:

hermes

Als je de Hermes-prompt ziet, is de opdracht klaar voor gebruik. Je kunt daarna hermes doctoruitvoeren; deze installatiecontrole vertelt je wat er nog ontbreekt.

Het programma op een externe schijf opslaan

Op 09-10-2026 werd Hermes Agent v0.21.6 geïnstalleerd op een externe schijf die op een Mac was aangesloten. Het programma werd opgeslagen op /Volumes/AItools/tools/hermes-agent, de opstartopdracht bevond zich op ~/.local/bin/hermes, en configuratie- en gespreksgegevens bleven in ~/.hermes.

Als je schijf een andere naam heeft, vervang dan het pad na --dir door je eigen map. De schijf moet aangesloten blijven terwijl Hermes draait.

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

Programma

Externe schijf

• tools/hermes-agent
• Bewaar de code hier

Opdracht

~/.local/bin/hermes

• Voer hermes in de terminal in
• Het wordt van kracht na het openen van een nieuw venster

Configuratie en chats

~/.hermes

• config.yaml staat hier
• Sluit af voordat je de schijf loskoppelt

Verbindingswaarden ophalen uit OmniProxy

Hier maakt Hermes verbinding met OmniProxy in plaats van direct met Grok of Gemini. Configureer de Grok- en Gemini-service-URL’s in OmniProxy; voer ze niet direct in Hermes in.

Jouw computer

Hermes

→

Lokale gateway

OmniProxy

• Voeg /v1 toe aan het adres

→

Grok

• grok-4.7

Gemini

• gemini-3.8-flash

Een model-ID is de exacte naam die de API gebruikt om een model te identificeren. Gebruik de volgende namen voor de twee modellen:

• Voer voor Grok grok-4.7in. De xAI API is https://api.x.ai/v1, en chatverzoeken gebruiken /v1/chat/completions. Zie de Grok modeldocumentatie.
• Voer voor Gemini gemini-3.8-flashin. Google’s OpenAI-compatibele API is https://generativelanguage.googleapis.com/v1beta/openai/. Zie Gemini’s OpenAI-compatibiliteitsdocumentatie.

Om Hermes naar Gemini te schakelen, wijzig je alleen de modelnaam naar gemini-3.8-flash. Blijf het OmniProxy-adres gebruiken als API-eindpunt.

Kopieer het eindpunt-URL en de sleutel uit OmniProxy en voer vervolgens het bijbehorende model-ID in:

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

Base URL is het eindpunt waarnaar Hermes verzoeken verstuurt. Het moet hier eindigen met /v1 . API Key is de sleutel die OmniProxy aan Hermes verstrekt. Vervang de tijdelijke aanduiding door je eigen waarde en publiceer deze niet op een openbare pagina.

Als je lokale OmniProxy-instantie geen sleutel vereist, kun je API Key leeg laten. Als het adres voor anderen toegankelijk is, moet je een sleutel gebruiken. Bevestig ook dat het adres bereikbaar is vanuit de omgeving waar Hermes draait. Als Hermes en OmniProxy op dezelfde computer staan, kun je een lokaal adres gebruiken.

De toolconfiguratie invoeren

Sluit eerst de huidige chat en voer daarna dit uit in een terminal:

hermes model

Selecteer Custom endpoint (self-hosted / VLLM / etc.). Custom endpoint betekent dat Hermes verbinding maakt met een serviceadres dat jij opgeeft in plaats van een vooraf ingestelde provider te gebruiken.

De installatiewizard vraagt achtereenvolgens om het eindpunt-URL, de sleutel en de modelnaam. Voer de drie waarden uit de vorige sectie in. Voer voor Gemini gemini-3.8-flash in als modelnaam.

Je kunt ook ~/.hermes/config.yaml direct bewerken. YAML is een tekstformaat dat inspringing gebruikt om configuratierelaties weer te geven. De volgende configuratie gebruikt Grok:

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

Wijzig voor Gemini default naar gemini-3.8-flash en laat de andere drie waarden ongewijzigd:

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

Voer na het opslaan hermes opnieuw uit en start een nieuwe chat. In een reeds geopende sessie /model kan alleen schakelen tussen providers die al zijn opgeslagen; het kan deze configuratie niet toevoegen.

Verifiëren met een echte taak

1

hermes doctor

• Installatiecontrole geslaagd

2

Stuur een kort bericht

• Zie een antwoord van Hermes

3

Open de verzoeklogboeken

• Verifieer de modelnaam

1. Voer hermes doctor uit om te controleren of de installatie voltooid is.
2. Voer hermes uit en vraag het om in één zin uit te leggen wat het kan doen. Je zou een antwoord moeten zien.
3. Open het OmniProxy-verzoeklogboek, bevestig dat het verzoek van Hermes kwam en controleer of de modelnaam grok-4.7 of gemini-3.8-flashis.

Zien dat de installatiewizard succesvol is opgeslagen, of dat de API een succesvol antwoord heeft geretourneerd, is niet genoeg om aan te tonen dat Hermes taken voor je kan voltooien. De modelnaam in het verzoeklogboek moet overeenkomen met de waarde die je hebt ingevoerd.

Voer het volgende lokaal uit om in een browser te chatten:

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

Open daarna http://127.0.0.1:9119. Dit adres werkt alleen op de huidige computer.

Veelvoorkomende fouten

• Het invoeren van hermes meldt dat de opdracht niet kan worden gevonden: Sluit de terminal en open een nieuw venster. Als de opdracht nog steeds niet wordt gevonden, bevestig dan dat ~/.local/bin in PATH staat. PATH is de lijst met mappen waar het systeem naar opdrachten zoekt. Bevestig op Windows dat de opstartmap die door het installatieprogramma is toegevoegd in PATH staat.
• De installatiedownload stopt halverwege: Voer dezelfde installatieopdracht opnieuw uit. De reeds gedownloade onderdelen worden opnieuw gebruikt.
• Hermes reageert niet of meldt dat het geen verbinding kan maken: Bevestig dat OmniProxy actief is en controleer of Base URL eindigt op /v1. Als Hermes in Docker draait terwijl OmniProxy op de host draait, gebruik dan niet 127.0.0.1 als dit alleen geldig is binnen de container.
• Er verschijnt een sleutelfout: Werk de OmniProxy-sleutel bij en wijzig daarna api_key in config.yaml. De xAI- of Google-sleutel hoort in de providerinstellingen van OmniProxy; voer deze niet in dit Hermes-veld in.
• Het model wordt gerapporteerd als onbeschikbaar: Open de huidige modellijst in OmniProxy en kopieer grok-4.7 of gemini-3.8-flash exact zoals deze in de lijst verschijnt.
• Hermes reageert wel, maar kan geen taken uitvoeren zoals bestanden lezen of opdrachten uitvoeren: Schakel over naar een ander model in OmniProxy dat die mogelijkheden heeft en start daarna een nieuwe Hermes-sessie.
• Het programma staat op een externe schijf en hermes doctor meldt een opslagfout nadat de schijf is losgekoppeld: Sluit de schijf eerst opnieuw aan. Laat Hermes geen aparte configuratie aanmaken terwijl de schijf is losgekoppeld.

Referenties

Zie de Hermes installatiedocumentatie en platformondersteuning voor installatiestappen. Zie de Hermes Provider-documentatie voor Custom endpoint-configuratie. Zie de Grok modeldocumentatie en Gemini’s OpenAI-compatibiliteitsdocumentatie voor de model-ID’s.

Het macOS-installatieproces werd op 09-10-2026 voltooid met Hermes Agent v0.21.6. grok-4.7 en gemini-3.8-flash waren op die datum de standaard model-ID’s in de xAI- en Google-documentatie. Gebruik bij het invoeren van de waarden de namen die in OmniProxy worden weergegeven.

Vervang elke placeholder met waarden uit uw eigen OmniProxy-configuratie. Publiceer nooit een echte sleutel.

Een opgeslagen resultaat of HTTP 200 alleen bewijst geen volledige Agent-compatibiliteit. Controleer de bron en het model in het oproeprecord van OmniProxy.

Officiële bronnen · Hermes ↗