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

Hermes Agent is een zelfgehoste, model-onafhankelijke AI-assistent die lokaal op een machine of een goedkope VPS draait, werkt via terminal- en berichtinterfaces 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 die is 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 een provider.

Als u het bredere beeld 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 concrete adoptiecijfers — 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 op elk meetbaar signaal.

Voor inrichtingsafwegingen en runtime-keuzen, LLM Hosting in 2026: Lokaal, Zelfgehost & Cloud Infrastructuur Vergelijk biedt de hostingkaart, terwijl LLM Prestaties in 2026: Benchmarks, Bottlenecks & Optimalisatie de kant van throughput en latentie behandelt zodra Hermes draait. Als u Hermes routineerwijs wijst naar Qwen of Gemma op lokale runtimes zoals Ollama, consolideer dan temperatuur- en penality presets 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 uw belangrijkste toegangspunt messaging op mobiel is, gebruik Hermes Spraakbesturing van uw Telefoon voor de spraakstack en platformspecifieke setup.

Mijn bevooroordeelde mening: Hermes is het meest interessant wanneer het wordt behandeld als infrastructuur, niet als een tabblad dat je af en toe opent. Zodra het als een dienst draait en een stabiele home directory heeft, beginnen je prompts minder op “chat” te lijken en meer op “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 door de tijd heen te verbeteren met een skills- en geheugensysteem.

Twee ontwerpkeuzes verdienen nadere toelichting omdat ze alles in deze gids beïnvloeden.

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

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

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

Als uw Hermes-setup Claude gebruikt via externe tooling-lagen, is deze wijziging in Anthropic-abonnementen een nuttige referentie waarom API-gebaseerde facturatie nu de verwachte route is.

Hermes Agent installeren

Hermes heeft een snelle installatiepad voor Linux, macOS en WSL2. De officiële documentatie houdt het intentioneel 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 uw shell en start de CLI.

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

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

Opmerkingen voor Windows en Android

Native Windows wordt niet ondersteund. De documentatie adviseert WSL2 en het draaien van Hermes daarin.

Voor Android ondersteunt Hermes een Termux-installatiepad. Het is ontworpen om Termux te detecteren en zijn dependency- en environment-setup 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 biedt 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 als volgt uit:

hermes model
hermes tools
hermes

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

Bewijs tooluitvoering vroeg

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

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

Voorbeeldprompt:

Toon mijn schijfgebruik en de vijf grootste mappen.

Als Hermes de terminal tool niet kan uitvoeren, spring dan naar Probleemoplossing. Terminal-backend misconfiguratie is een van de meest voorkomende oorzaken, en de oplossing is meestal duidelijk zodra u naar de configuratie 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 nog” problemen vandaan komen.

Waar configuratie en state wonen

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

Dit is om twee redenen belangrijk.

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

Config precedent en secrets buiten config.yaml houden

Hermes lost configuratie op met een precedentvolgorde. Aan de top staan CLI-overschrijvingen, dan config.yaml, dan .env, met ingebouwde defaults aan de onderkant.

Het mooie detail is dat hermes config set waarden naar het juiste bestand stuurt: API-keys naar .env en niet-secret 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 omgevingsvariabele substitutie binnen config.yaml via ${VAR_NAME} syntaxis. Dit is handig wanneer u bepaalde waarden in de omgeving wilt houden terwijl u ze nog steeds referent in gestructureerde config.

Sandbox en uitvoeringsbackends

Hermes ondersteunt meerdere terminal backends die definiëren waar shell-commando’s daadwerkelijk draaien. De configgids lijst local, docker, ssh, modal, daytona en singularity op.

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

• local is het snelste en eenvoudigst, maar het is niet geïsoleerd
• docker is een pragmatische veiligheid- en reproduceerbaarheidslaag
• ssh is een schone manier om uw chatapparaat te scheiden van uw compute-box
• modal en daytona passen bij “serverless maar persistent genoeg” workflows
• singularity is de HPC-vriendelijke optie

Een minimaal 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 security hardening voor de Docker-backend, zoals het laten vallen van capabilities en het uitschakelen van privilege escalation.

Skills, geheugen en profielen

Hermes heeft twee gerelateerde mechanismen voor het composteren van waarde.

Skills zijn procedureel geheugen. Hermes kan zijn eigen skills aanmaken, bijwerken en verwijderen en kan voorstellen om een aanpak als skill op te slaan 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 herinneringsvermogen. De geheugendocumentatie lijst meerdere provider plugins op, 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 Echt Werkt.

Als u meerdere onafhankelijke agents op dezelfde machine wilt, bieden Hermes profielen isolatie. Elk profiel krijgt zijn eigen directory met zijn eigen config, secrets, geheugens, sessies, skills, cron jobs en gateway state.

Voor een diepere blik op welke skills goed werken in productie per rol — engineers, researchers, operators en executive workflows — zie Hermes AI Assistant Skills voor Echte Productie Setups. Wanneer u klaar bent om SKILL.md bestanden zelf te maken of te debuggen—YAML metadata, progressieve onthulling niveaus, conditionele zichtbaarheid en hub installs—gebruik Hermes Agent Skill Authoring — SKILL.md Structuur en Best Practices.

Typische workflow

Als u Hermes behandelt als een agent die u zult behouden, begint de workflow te lijken op service engineering.

Een stabiele baseline

Een baseline die neigt om niet te rotten is:

1. Installeer en voer een eerste chat uit in de CLI.
2. Kies een provider en model met hermes model, en bevestig kosten.
3. Configureer toolsets en beslis of terminaluitvoering lokaal of sandboxed is.
4. Maak een snelle wijziging in SOUL.md pas nadat u de default een tijdje hebt gebruikt. Identiteitsveranderingen zijn belangrijker dan mensen verwachten omdat het “slot 1” is in de system prompt.

Dagelijks gebruik dat composteren

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 output.

In de praktijk is een nuttige cadans:

• werk uitvoeren in een benoemde sessie voor een project
• context comprimeren wanneer het te groot wordt
• laat Hermes herhaalde routines omzetten in skills
• houd een mentale grens tussen “vragen” en “handelen” zodat tooluitvoering 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 verbindt met meerdere platforms, sessies behandelt, cron jobs uitvoert en berichten levert.

Setup wordt aangeroepen via hermes gateway setup, en de gateway kan in de foreground draaien of als een user service. 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 limits, dependency chains en cron-gebaseerde batching behandelt.

Veiligheid 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 uitgeeft en goedkeuring vereist via hermes pairing approve.

Updates zonder drama

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

hermes update
hermes doctor
hermes gateway status

Probleemoplossing 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 core loop:

• hermes doctor voor interactieve diagnostiek
• hermes status voor een snel overzicht
• hermes dump voor een deelbare, geredacteerd setup samenvatting

Voor logs, hermes logs tails 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 lijst enkele terugkerende problemen en hun oplossingen op, waaronder Python-versieproblemen, uv niet gevonden, en machtigingsproblemen veroorzaakt door het mengen van sudo-installs met user-installs.

Als u deze fouten tegenkomt, bieden de documentatie specifieke herstelstappen zoals het upgraden van Python, het installeren van uv, en het opnieuw installeren van Hermes zonder sudo.

Provider- en modelproblemen

Wanneer API-keys niet werken, beveelt de FAQ aan om configuratie te controleren, hermes model opnieuw te draaien, of een key direct in te stellen via hermes config set. Het benadrukt ook een veelvoorkomende valkuil: keys 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 overschrijvingen.

Rate limiting en contextlengteproblemen worden ook behandeld. De FAQ suggereert om te wachten op 429 errors, van provider of model te wisselen, en contextdruk te verminderen via compressie of een nieuwe sessie.

Terminal backend en gateway problemen

Als terminal commando’s onmiddellijk falen, bevat de configuratiegids een “veelvoorkomende terminal backend problemen” sectie en wijst naar de typische oorzaken per backend, inclusief Docker niet draaien en ontbrekende SSH variabelen. Het merkt ook op dat terugvallen naar local een geldige debugbeweging 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.

Referenties

• Hermes Agent Homepage
• Hermes Agent Geheugensysteem: Hoe Persistent AI-Geheugen Echt Werkt
• Hermes AI Assistant Skills voor Echte Productie Setups