Hermes Agent: installeren en instellen

Hermes Agent: Review Nieuws

Stand september 2026, samengesteld uit onze eigen notities en nieuwsarchief; tekst machinaal opgesteld en redactioneel gecontroleerd. Controleer versies en commando's in de officiële documentatie.

In deze handleiding installeer je Hermes Agent, de open-source agent van Nous Research die onthoudt, zelf vaardigheden aanleert en ook via chatapps bereikbaar is. Je kiest een model, zet je sleutels veilig weg en controleert of alles werkt. Alles komt uit de officiële documentatie (stand september 2026).

Wat je nodig hebt

Besturingssysteem: Linux, macOS op Apple Silicon, Windows, WSL 2 of Android (Termux). Macs met een Intel-processor worden niet ondersteund.
Toegang tot een taalmodel: een API-sleutel van een provider of een OpenAI-compatibel endpoint, bijvoorbeeld een lokaal model of je eigen router.

Python, Git en de pakketbeheerder uv hoef je niet zelf te installeren: de installer regelt dat, met Python 3.14.

Installeren

Linux, macOS en WSL 2:

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

Windows (PowerShell):

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

Laad daarna je shell opnieuw, zodat het commando hermes gevonden wordt:

source ~/.bashrc      # of ~/.zshrc op een Mac

Instellen met de wizard

De makkelijkste manier om alles in te stellen:

hermes setup

De wizard loopt langs model, provider en de belangrijkste opties. Alleen het model kiezen of wisselen kan ook los:

hermes model

Waar alles staat

Hermes bewaart alles in ~/.hermes/ (op Windows in %LOCALAPPDATA%\hermes\; met HERMES_HOME kies je een andere plek):

config.yaml: model, terminal-backend en overige instellingen.
.env: API-sleutels en andere geheimen.
SOUL.md: de identiteit en toon van je agent.
memories/: wat de agent over jou en je werk onthoudt.
skills/: vaardigheden die de agent zelf aanmaakt of die je installeert.

Vuistregel: geheimen horen in .env, al het andere in config.yaml. Het commando hermes config set regelt dat automatisch: namen in HOOFDLETTERS_MET_UNDERSCORES gaan naar .env.

hermes config set ANTHROPIC_API_KEY sk-ant-...
hermes config set OPENAI_API_KEY sk-...

Eerste veiligheidsinstellingen

Hermes kan shellcommando's uitvoeren en draait standaard op je eigen machine. Zet voor een voorzichtige start in ~/.hermes/config.yaml:

agent:
  dangerous_command_approval: true   # vraag toestemming voor risicovolle commando's
skills:
  write_approval: true               # laat je eerst zien wat de agent aan skills wijzigt
  guard_agent_created: true          # scan zelfgemaakte skills op gevaarlijke patronen

Wil je dat Hermes commando's in een afgeschermde omgeving draait in plaats van direct op je systeem? Zie de tutorial over de Docker-backend.

Controleren of het werkt

hermes doctor

Dit controleert je installatie, configuratie en sleutels. Start daarna een gesprek:

hermes

Geef een eenvoudige opdracht, zoals "Vat de README in deze map samen", en kijk of het antwoord klopt.

Optioneel: Hermes via Telegram of Discord

Hermes kan ook berichten ontvangen via meer dan twintig chatplatformen. De wizard:

hermes gateway setup

Standaard mag niemand met je bot praten, behalve gebruikers die je expliciet toestaat of die je via een koppelcode goedkeurt. Laat dat zo: een bot met toegang tot je terminal hoort niet open te staan voor iedereen.

Bijwerken en verwijderen

hermes update --check   # kijken wat er nieuw is
hermes update           # bijwerken; draaiende gateways worden herstart

Bij het bijwerken maakt Hermes eerst een snapshot en rolt het terug als de nieuwe code niet klopt. Verwijderen kan met hermes uninstall. Je configuratie en gegevens blijven daarbij staan, tenzij je --full meegeeft.