Hermes AI-assistent: installeren, instellen, workflow en probleemoplossing

Installatie en quickstart van de Hermes Agent voor ontwikkelaars

Inhoud

Hermes Agent is een zelfgehoste, model-onafhankelijke AI-assistent die lokaal op een machine of een goedkope VPS draait, werkt via terminal- en messaginginterfaces en in de loop van de tijd verbetert door herhaalde taken om te zetten in herbruikbare vaardigheden.

Het is qua functionaliteit zeer vergelijkbaar met OpenClaw, een ander zelfgehost assistentstack gebouwd rondom tools, geheugen en lokale controle. Veel ontwikkelaars vonden hun weg naar Hermes nadat Anthropic de toegang tot OpenClaw’s Claude-abonnement blokkeerde in april 2026 — de OpenClaw-opkomst en -val-tijdlijn legt uit waarom Hermes de natuurlijke bestemming werd voor gebruikers die persistente, zelfgehoste automatisering wilden zonder afhankelijkheid van de provider.

Als je het bredere beeld wilt zien van zelfgehoste assistenten, retrieval en lokale infrastructuur rondom Hermes, dit overzicht van AI-systemen koppelt die onderwerpen aan dezelfde problemen die Hermes probeert op te lossen.

Voor deployment-compromissen en runtime-keuze biedt LLM Hosting in 2026: Lokaal, Zelfgehost & Cloud Infrastructuur Vergelijken de hostingkaart, terwijl LLM Prestaties in 2026: Benchmarks, Bottlenecks & Optimalisatie de kant van throughput en latentie behandelt zodra Hermes draait. Voor een compacte kaart van shell-commando’s (hermes gateway, hermes memory, hermes doctor, slash-shortcuts en meer), gebruik de Hermes Agent CLI cheat sheet.

peronal-ai-assistant on laptop

Mijn bevooroordeelde mening: Hermes is het meest interessant wanneer je het behandelt als infrastructuur, niet als een tabblad dat je af en toe opent. Zodra het als een service draait en een stabiele home-directory heeft, beginnen je prompts er minder uitzien als “chat” en meer als “ops”.

Wat Hermes Agent is en waarom het belangrijk is

Hermes Agent is een open-source AI-agent gebouwd door Nous Research. Het is ontworpen om persistent te draaien, tools te gebruiken (terminal, bestanden, web en meer) en zijn eigen gedrag in de loop van de tijd te verbeteren met een systeem voor vaardigheden en geheugen.

Twee ontwerpkiezen verdienen nadere uitleg omdat ze alles anders in deze gids bepalen.

Ten eerste is Hermes niet gebonden aan één enkele modelprovider. De officiële setup-flow ondersteunt meerdere providers en elk OpenAI-compatibel eindpunt, en schakelen gebeurt via het hermes model-commando in plaats van code-aanpassingen.

Ten tweede trekt Hermes een harde lijn tussen “conversatie” en “executie”. De agent kan de hele dag praten, maar wanneer het actie moet ondernemen, doet het dat via expliciete tools en een configureerbare uitvoeringsbackend. Dat is waar veiligheid, reproduceerbaarheid en troubleshooting thuishoren.

Kosten en licentie zijn verfrissend saai. Hermes Agent zelf is gratis software onder de MIT-licentie. Als je gehoste modellen gebruikt, zijn de lopende kosten wat je provider in rekening brengt. Als je lokale modellen draait, kun je API-kosten volledig vermijden.

Als je Hermes-setup Claude gebruikt via externe tooling-lagen, is deze Anthropic-abonnementswijziging een nuttige referentie over waarom API-gebaseerde facturatie nu de verwachte weg is.

Hermes Agent installeren

Hermes heeft een snelle installatieweg voor Linux, macOS en WSL2. De officiële documentatie houdt het opzettelijk simpel.

Hermes installeren op Linux

sudo apt-get update
sudo apt-get upgrade
sudo apt-get curl git
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Na installatie, herlaad je shell en start de CLI.

source ~/.bashrc   # of source ~/.zshrc
hermes

De installer is niet slechts een dunne wrapper. Volgens de installatiegids stelt het afhankelijkheden, de repo, een virtuele omgeving en het hermes-commando in, en brengt het je naar een eerste chat-klaar staat.

Opmerkingen voor Windows en Android

Native Windows wordt niet ondersteund. De documentatie beveelt WSL2 aan en het draaien van Hermes daarbinnen.

Voor Android ondersteunt Hermes een Termux-installatieweg. Het is ontworpen om Termux te detecteren en zijn afhankelijkheids- en omgevingsetup dienovereenkomstig aan te passen.

Quickstart

De snelste eerste run is letterlijk gewoon hermes, maar een zinvolle quickstart betekent twee extra beslissingen: welke modelprovider te gebruiken en welke tools ingeschakeld moeten worden.

Kies een provider en model

Hermes presenteert drie complementaire ingangen:

hermes model om een provider en standaardmodel te kiezen
hermes tools om toolsets in- of uit te schakelen
hermes setup om een interactieve wizard te draaien voor de belangrijkste configuratiegebieden

Een minimale flow ziet er als volgt uit:

hermes model
hermes tools
hermes

Wat betreft wat daadwerkelijk wordt ondersteund, noemt de officiële Quickstart een reeks providers en benadrukt ook dat Hermes werkt met OpenAI-compatibele API’s. Dat is belangrijk omdat het zowel gehoste services als zelfgehoste eindpunten omvat.

Bewijs tool-executie vroeg

Voordat je gewoonten bouwt rondom Hermes, is het de moeite waard om te verifiëren dat toolgebruik werkt in je omgeving. De Quickstart suggereert expliciet terminalgebruik als eerste functie om te proberen.

In de praktijk doet een kleine “smoke test”-prompt twee taken: het controleert het terminaltool en valideert machtigingsprompts.

Voorbeeldprompt:

Toon mijn schijfgebruik en de vijf grootste mappen.

Als Hermes het terminaltool niet kan uitvoeren, spring dan vooruit naar Probleemoplossen. Misconfiguratie van de terminalbackend is een van de meest voorkomende oorzaken, en de oplossing is meestal duidelijk zodra je naar de config kijkt.

Configuratie die schaleert

Hermes beloont mensen die begrijpen waar het staat opslaat en hoe het configuratie oplost. Dit is ook waar veel “het werkte gisteren”-problemen vandaan komen.

Waar configuratie en staat wonen

Hermes bewaart zijn instellingen en staat onder ~/.hermes. De officiële configuratiegids documenteert de lay-out, inclusief config.yaml voor instellingen, .env voor secrets, auth.json voor OAuth-aanmeldgegevens, SOUL.md voor identiteit, en mappen voor geheugens, vaardigheden, cron, sessies en logs.

Dit is om twee redenen belangrijk.

Debuggen wordt mechanisch omdat je precies weet waar je moet kijken.
Back-ups worden eenvoudig omdat één directory het meeste agent-state vastlegt dat je belangrijk vindt.

Config-precedentie en secrets buiten config.yaml houden

Hermes lost configuratie op met een precedentiereeks. Bovenaan staan CLI-overrides, dan config.yaml, dan .env, met ingebouwde standaarden onderaan.

Het mooie detail is dat hermes config set waarden doorstuurt naar het juiste bestand: API-sleutels naar .env en niet-secrete instellingen naar config.yaml.

hermes config set model openrouter/meta-llama/llama-3.1-70b-instruct
hermes config set terminal.backend docker
hermes config set OPENROUTER_API_KEY sk-or-v1-xxxxxxxx

Hermes ondersteunt ook omgevingsvariabelsubstitutie binnen config.yaml via ${VAR_NAME}-syntax. Dit is handig wanneer je bepaalde waarden in de omgeving wilt houden terwijl je ze nog steeds refereert in gestructureerde config.

Sandbox en uitvoeringsbackends

Hermes ondersteunt meerdere terminalbackends die definiëren waar shell-commando’s daadwerkelijk worden uitgevoerd. De configgids noemt local, docker, ssh, modal, daytona en singularity.

De meningsvol maar niet evangelische manier om hierover na te denken is:

local is het snelst en eenvoudigst, maar het is niet geïsoleerd
docker is een pragmatische veiligheids- en reproduceerbaarheidslaag
ssh is een schone manier om je chatapparaat te scheiden van je computebox
modal en daytona passen bij “serverless maar persistent genoeg” workflows
singularity is de HPC-vriendelijke optie

Een minimale Docker-backend voorbeeld:

# ~/.hermes/config.yaml
terminal:
  backend: docker
  docker_image: "nikolaik/python-nodejs:python3.11-nodejs20"
  docker_volumes:
    - "/home/user/projects:/workspace/projects"
  docker_forward_env:
    - "GITHUB_TOKEN"

De documentatie beschrijft ook beveiligingsversterkingen voor de Docker-backend, zoals het weghalen van capabilities en het uitschakelen van privilege-escalatie.

Vaardigheden, geheugen en profielen

Hermes heeft twee gerelateerde mechanismen voor het opbouwen van waarde.

Vaardigheden zijn procedureel geheugen. Hermes kan zijn eigen vaardigheden maken, bijwerken en verwijderen en kan voorstellen om een aanpak op te slaan als vaardigheid na het voltooien van een complexe taak.

Ingebouwd geheugen wordt opgeslagen als bestanden zoals MEMORY.md en USER.md onder ~/.hermes, en Hermes kan ook externe geheugenproviders gebruiken voor diepere recall. De geheugendocumentatie noemt meerdere providerplugins, en de geheugenprovidersgids documenteert een interactieve setup-flow. Voor een volledige technische uitsplitsing van hoe de geheugenarchitectuur werkt — bevroren snapshots, karakterslimieten, de acht externe providers en de filosofie achter gebonden geheugen — zie Hermes Agent Geheugensysteem: Hoe Persistent AI-geheugen Werkelijk Werkt.

Als je meerdere onafhankelijke agents op dezelfde machine wilt, bieden Hermes-profielen isolatie. Elk profiel krijgt zijn eigen directory met zijn eigen config, secrets, geheugens, sessies, vaardigheden, cron-taken en gateway-staat.

Voor een diepere kijk op welke vaardigheden goed werken in productie per rol — engineers, onderzoekers, operators en executive workflows — zie Hermes AI Assistant Vaardigheden voor Werkelijke Productie-setups. Wanneer je klaar bent om SKILL.md-bestanden zelf te schrijven of te debuggen — YAML-metadata, niveaus van progressieve openbaarmaking, conditionele zichtbaarheid en hub-installs — gebruik Hermes Agent Vaardigheidsschrijven — SKILL.md Structuur en Best Practices.

Typische workflow

Als je Hermes behandelt als een agent die je zult behouden, begint de workflow eruit te zien als service-engineering.

Een stabiele baseline

Een baseline die geneigd is niet te verrotten is:

Installeer en draai een eerste chat in de CLI.
Kies een provider en model met hermes model, en bevestig kosten.
Configureer toolsets en beslis of terminal-uitvoering lokaal of gesandboxt is.
Maak een snelle wijziging in SOUL.md pas nadat je de default een tijdje hebt gebruikt. Identiteitsveranderingen zijn belangrijker dan mensen verwachten omdat het “slot 1” is in de system prompt.

Dagelijks gebruik dat opbouwt

Hermes heeft een terminal-UI in plaats van een web-UI, en het is ontworpen voor lange sessies met slash-commando’s, hervatbare sessies en streaming tool-uitvoer.

In de praktijk is een nuttige cadens:

werk uitvoeren in een benoemde sessie voor een project
context comprimeren wanneer het te groot wordt
Hermes laten herhaalde routines omzetten in vaardigheden
een mentale grens houden tussen “vragen” en “handelen” zodat tool-uitvoering auditabel blijft

Messaging gateway voor 24/7 toegang

De messaging gateway is het stuk dat Hermes voelt als een assistent in plaats van een terminalapp. De documentatie beschrijft het als een enkel proces dat verbinding maakt met meerdere platforms, sessies afhandelt, cron-taken uitvoert en berichten levert.

Setup wordt aangeroepen via hermes gateway setup, en de gateway kan in de voorgrond draaien of als een gebruikersservice. De CLI-referentie documenteert gateway-subcommando’s zoals run, install, start, stop, status en restart.

Voor multi-agent backlogs en gecontroleerde planning, zie Kanban in Hermes Agent voor Zelfgehoste LLM Workflows, die dispatcher-limieten, afhankelijkheidsketens en cron-gebaseerde batching behandelt.

Beveiliging voor een tool-gebruikende bot is belangrijk. De gateway-documentatie beschrijft allowlists voor specifieke platforms en een DM-pairing-flow die eenmalige pairing-codes uitdeelt en goedkeuring vereist via hermes pairing approve.

Updates zonder drama

Hermes-updates zijn een first-class commando. De updategids documenteert hermes update, config-migratiechecks en een kleine post-update validatieroutine inclusief hermes doctor en hermes gateway status.

hermes update
hermes doctor
hermes gateway status

Probleemoplossen en diagnostiek

De meeste Hermes-falen zijn niet mysterieus. Ze zien er mysterieus uit omdat mensen alleen de model-laag controleren en de runtime-laag negeren.

Snelle triage-commando’s

De CLI-referentie positioneert expliciet drie commando’s als de kernloop:

hermes doctor voor interactieve diagnostiek
hermes status voor een snel overzicht
hermes dump voor een deelbare, geredigeerde samenvatting van de setup

Voor logs, hermes logs tailt bestanden opgeslagen onder ~/.hermes/logs.

hermes doctor --fix
hermes status
hermes dump --show-keys
hermes logs errors -f

Veelvoorkomende installatiefalen

De FAQ en probleemoplossingsgids noemt enkele terugkerende problemen en hun oplossingen, waaronder Python-versieproblemen, uv niet gevonden, en machtigingsproblemen veroorzaakt door het mengen van sudo-installs met gebruikersinstalls.

Als je deze fouten tegenkomt, bieden de documentatie specifieke remediatie-stappen zoals het upgraden van Python, het installeren van uv, en het opnieuw installeren van Hermes zonder sudo.

Provider- en modelproblemen

Wanneer API-sleutels niet werken, beveelt de FAQ aan de configuratie te controleren, hermes model opnieuw uit te voeren, of een sleutel direct in te stellen via hermes config set. Het noemt ook een veelvoorkomende valkuil: sleutels zijn provider-specifiek.

Voor “model niet gevonden”-problemen wijst de FAQ terug naar het gebruik van hermes model om een geldige identifier te kiezen en toont zowel config- als per-sessie overrides.

Rate-limieten en contextlengteproblemen worden ook behandeld. De FAQ stelt voor te wachten op 429-fouten, van provider of model te wisselen, en contextdruk te verminderen via compressie of een nieuwe sessie.

Terminal-backend en gateway-problemen

Als terminalcommando’s onmiddellijk falen, bevat de configuratiegids een sectie “veelvoorkomende terminal-backendproblemen” en wijst naar de typische oorzaken per backend, inclusief Docker niet draaien en ontbrekende SSH-variabelen. Het merkt ook op dat terugvallen op local een geldige debugging-stap is wanneer sandbox-configuratie in vraag staat.

Voor gateway-problemen benadrukt de messaginggids allowlists en pairing als de veilige defaults, wat betekent dat veel “bot is stil”-incidenten eigenlijk autorisatie zijn die zijn werk doet.