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 een enkele 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 daarna 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 installers 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 installatie op gewone computers.

Wil je een venster

macOS, Windows

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

Alleen terminal

Linux, macOS, WSL2

• Eén install.sh commando
• 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 lastig 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 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 de installer voor jouw besturingssysteem. De installer 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. Deze installer 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-installers zijn voor macOS en Windows. Gebruik op Linux het onderstaande terminalcommando. 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 het volgende uit bij gebruik van de PowerShell in Windows:

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

De installer downloadt de Hermes-code en de programma’s die nodig zijn om deze uit te voeren. Als de download wordt onderbroken, voer dan hetzelfde commando 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 het commando klaar voor gebruik. Je kunt daarna hermes doctoruitvoeren; deze installatiecontrole vertelt je wat er nog ontbreekt.

Het programma op een externe schijf opslaan

Op 9 oktober 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, het opstartcommando 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 verbonden blijven terwijl Hermes actief is.

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

Commando

~/.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 de eindpunt-URL en sleutel uit OmniProxy en voer daarna 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 op /v1 . API Key is de sleutel die OmniProxy aan Hermes verstrekt. Vervang de placeholder 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.

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 de eindpunt-URL, sleutel en modelnaam. Voer de drie waarden uit de vorige sectie in. Om Gemini te gebruiken, voer je 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>

Om Gemini te gebruiken, wijzig je default naar gemini-3.8-flash en laat je 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 slaagt

2

Stuur een kort bericht

• Zie een antwoord van Hermes

3

Open de verzoeklogs

• 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-verzoeklog, 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 gaf, is niet genoeg om aan te tonen dat Hermes taken voor je kan voltooien. De modelnaam in het verzoeklog 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 het commando niet kan worden gevonden: Sluit de terminal en open een nieuw venster. Als het commando nog steeds niet wordt gevonden, bevestig dan dat ~/.local/bin in PATH staat. PATH is de lijst met mappen waar het systeem naar commando’s zoekt. Bevestig op Windows dat de opstartmap die door de installer is toegevoegd in PATH staat.
• De installatiedownload stopt halverwege: Voer hetzelfde installatiecommando opnieuw uit. De reeds gedownloade delen worden hergebruikt.
• 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 precies zoals het in de lijst staat.
• Hermes reageert wel, maar kan geen taken uitvoeren zoals bestanden lezen of commando’s 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 niet volledige agentcompatibiliteit. Controleer de bron en het model in de verzoeklog van OmniProxy.

Officiële bronnen · Hermes ↗