Hermes AI-assistent – installeren, configureren, workflow en probleemoplossing

Installatie en quickstart voor ontwikkelaars

Inhoud

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

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

Als je het bredere plaatje wilt zien van zelfgehoste assistenten, retrieval en lokale infrastructuur rondom Hermes, dan dit overzicht van AI-systemen koppelt deze onderwerpen aan dezelfde problemen die Hermes probeert op te lossen. Voor het vijflaagse assistentmodel — LLM, geheugen, tooling, routing en observability — met Hermes en OpenClaw als referentie-implementaties, zie AI-Assistentenarchitectuur. Voor concrete adoptiegegevens — GitHub-sterren, OpenRouter-dagelijkse tokenvolume, PyPI-downloadaantallen, CVE-geschiedenis en Reddit-community-sentiment — OpenClaw vs Hermes Agent: Sterren, Downloads & Gebruik 2026 volgt hoe Hermes zich verhoudt tot 19 alternatieven over alle meetbare signalen.

Voor deployment-afwegingen en runtime-keuze, LLM-hosting in 2026: Lokaal, Zelfgehost & Cloud-infrastructuur vergeleken biedt de hostingkaart, terwijl LLM-prestaties in 2026: Benchmarks, Bottlenecks & Optimalisatie de kant van throughput en latentie behandelt zodra Hermes draait. Als je Hermes routinematig wijst op Qwen of Gemma op lokale runtimes zoals Ollama, dan consolideer je temperatuur- en penalty-presetten voor multi-step toolgebruik met Agentic LLM-inferentieparameters voor Qwen en Gemma. 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. Als je belangrijkste toegangspunt messaging op mobiel is, gebruik dan Hermes Voice Control van je Telefoon voor de voice stack en platform-specifieke setup.

persoonlijke-ai-assistent op laptop

Mijn bevooroordeelde mening: Hermes is het meest interessant wanneer hij wordt behandeld als infrastructuur, niet als een tab die je af en toe opent. Zodra hij 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. Hij is ontworpen om persistent te draaien, tools te gebruiken (terminal, bestanden, web en meer) en zijn eigen gedrag door de tijd heen te verbeteren met een systeem voor vaardigheden en geheugen.

Twee ontwerpskeuzes zijn het waard om uit te schrijven omdat ze alles anders in deze gids beïnvloeden.

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

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

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 ook maar rekent. Als je lokale modellen draait, kun je API-kosten volledig vermijden.

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

Hermes Agent installeren

Hermes heeft een snelle installatiepad 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 alleen een dunne wrapper. Volgens de installatiegids stelt hij dependencies in, de repo, een virtuele omgeving en het hermes-commando, en brengt je naar een eerste chat-klare 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-installatiepad. Het is ontworpen om Termux te detecteren en zijn dependency- en omgevingssetup 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 moeten worden ingeschakeld.

Kies een provider en model

Hermes exposeert drie complementaire toegangspunten:

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 over belangrijke configuratiegebieden

Een minimale flow ziet er zo uit:

hermes model
hermes tools
hermes

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

Bewijs tool-uitvoering 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 de terminaltool en valideert machtigingsprompts.

Voorbeeldprompt:

Toon mijn schijfgebruik en de vijf grootste directories.

Als Hermes de terminaltool niet kan uitvoeren, sla dan over naar Troubleshooting. Misconfiguratie van de terminalbackend is een van de meest voorkomende oorzaken, en de oplossing is meestal duidelijk zodra je naar de configuratie kijkt.

Configuratie die schaalbaar is

Hermes beloont mensen die begrijpen waar hij staat opslaat en hoe hij 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-gegevens, 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 precedentiële volgorde. Bovenaan staan CLI-overrides, dan config.yaml, dan .env, met ingebouwde standaarden onderaan.

Het leuke detail is dat hermes config set waarden naar het juiste bestand stuurt: 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 omgevingsvariabel-substitutie binnen config.yaml via ${VAR_NAME}-syntax. Dit is handig wanneer je bepaalde waarden in de omgeving wilt houden terwijl je ze nog steeds in gestructureerde configuratie refereert.

Sandbox en uitvoeringsbackends

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

De meningsvolle 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 laag voor veiligheid en reproduceerbaarheid
ssh is een schone manier om je chatapparaat te scheiden van je compute-box
modal en daytona passen bij “serverless maar persistent genoeg” workflows
singularity is de HPC-vriendelijke optie

Een minimale Docker-backendvoorbeeld:

# ~/.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 security hardening voor de Docker-backend, zoals het verlagen van capabilities en het uitschakelen van privilege-escalation.

Vaardigheden, geheugen en profielen

Hermes heeft twee gerelateerde mechanismen voor het cumuleren van waarde.

Vaardigheden zijn procedureel geheugen. Hermes kan zijn eigen vaardigheden maken, bijwerken en verwijderen en kan aanbieden 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 dieper herinneren. De geheugendocumentatie noemt meerdere provider-plugins, 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 begrensd geheugen — zie Hermes Agent Geheugensysteem: Hoe Persistent AI-Geheugen Eigenlijk Werkt.

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

Voor een diepere blik op welke vaardigheden goed werken in productie per rol — engineers, onderzoekers, operators en executive workflows — zie Hermes AI-Assistent Vaardigheden voor Echte Productie-Setups. Wanneer je klaar bent om SKILL.md-bestanden zelf te schrijven of te debuggen — YAML-metadata, progressieve disclosiureniveaus, conditionele zichtbaarheid en hub-installs — gebruik dan Hermes Agent Skill Authoring — SKILL.md Structuur en Best Practices.

Typische workflow

Als je Hermes behandelt als een agent die je in de buurt houdt, begint de workflow eruit te zien als service-engineering.

Een stabiele baseline

Een baseline die geneigd is niet te rotten is:

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

Dagelijks gebruik dat cumuleert

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

In de praktijk is een nuttige cadentie:

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 doet voelen 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 bezorgt.

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. Als je dit gateway-model wilt laten draaien op een dedicated server terwijl je verbinding maakt vanaf een aparte desktopclient, gebruik dan Hermes Agent Headless Server en Remote Desktop Setup.

Voor multi-agent backlogs en gecontroleerde planning, zie Kanban in Hermes Agent voor Self Hosted LLM Workflows, die dispatcher-limiten, 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 one-time 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-migratiecontroles en een kleine post-update validatieroutine inclusief hermes doctor en hermes gateway status.

hermes update
hermes doctor
hermes gateway status

Troubleshooting en diagnostiek

De meeste Hermes-falen zijn niet mysterieus. Ze zien er mysterieus uit omdat mensen alleen de modelllaag 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, gecensureerde samenvatting van de setup

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

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

Veelvoorkomende installatiefalen

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

Als je deze errors tegenkomt, bieden de documenten 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 om de configuratie te controleren, hermes model opnieuw te draaien, of een sleutel direct in te stellen via hermes config set. Het wijst ook op 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-limiting en contextlengteproblemen worden ook behandeld. De FAQ suggereert om te wachten voor 429-errors, 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 over “veelvoorkomende terminal-backendproblemen” en wijst naar de typische oorzaken per backend, inclusief Docker die niet draait en ontbrekende SSH-variabelen. Het merkt ook op dat terugvallen naar local een geldige debugging-beweging is wanneer sandbox-configuratie in vraag staat.

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