Hermes Agent zelf installeren: wat je nodig hebt en waar je op let
De installatie van Hermes Agent is één regel in een terminal. Daarna begint het eigenlijke werk: een model kiezen, een server regelen, de chatkoppeling opzetten en de beveiliging goed zetten. Wat je nodig hebt om Hermes Agent zelf te installeren, op een laptop, een server of in Docker.

Wie de GitHub-pagina van Hermes Agent opent, ziet het al snel staan: één regel om te kopiëren, plakken in de terminal en klaar. Dat klopt ook. De installatie zelf duurt een paar minuten. Maar wie daarna een agent wil die elke ochtend je mail doorneemt terwijl je laptop dicht is, heeft nog een paar keuzes te maken.
In dit artikel lees je hoe je Hermes Agent zelf installeren aanpakt: wat je nodig hebt, welke installatiemethode bij jouw situatie past en welke instellingen je niet moet overslaan. Alles hieronder is gecontroleerd in de officiële repository en de documentatie van Nous Research, stand november 2026. De software verandert snel, dus check bij twijfel altijd de documentatie zelf.
Wat Hermes Agent is, in het kort
Hermes Agent is een open source AI agent van Nous Research, uitgebracht onder de MIT-licentie en geschreven in Python. Hij draait op je eigen computer of server, werkt met het taalmodel dat jij kiest en is bereikbaar via de terminal of via chatapps als Telegram, Slack, WhatsApp, Discord en Signal. Hij heeft een eigen geheugen, maakt na lastige taken zelf vaardigheden aan (skills) en kan taken op een schema uitvoeren. Wil je eerst weten wat een agent eigenlijk is, lees dan wat is een AI agent.
Systeemeisen en ondersteunde platforms
De documentatie deelt platforms in twee niveaus in. Volledig ondersteund zijn:
- macOS op Apple Silicon, via de desktopapp of het installatiescript
- Windows 10 en 11, via een PowerShell-script of een desktoppakket
- Linux en WSL2, getest op de nieuwste Ubuntu
- Docker, op x86_64 en ARM
Nix en Android via Termux worden alleen naar beste kunnen onderhouden. Installeren via pip of Homebrew wordt uitdrukkelijk niet ondersteund, en een desktopapp voor Intel-Macs wordt niet meer gebouwd. Op een Intel-Mac kun je wel de commandoregelversie installeren. Zie de pagina Platform Support.
Voor het installatiescript op Linux en macOS heb je Git, curl en tar nodig. Python hoef je niet zelf te regelen: het script zet een eigen, vaste versie neer (op dit moment Python 3.14), samen met Node.js en de andere hulpprogramma's die Hermes gebruikt.
Drie manieren om te installeren
Op je eigen computer. Op Linux, macOS en WSL2 draai je het installatiescript van de officiële site met curl. Op Windows doe je hetzelfde met een PowerShell-opdracht. Op macOS en Windows kun je ook de desktopapp downloaden, waarin alles al zit. Na de installatie start je met het commando hermes en kun je direct een gesprek beginnen.
Op een server. Dit is de route als je wilt dat de agent dag en nacht draait. Volgens de README draait hij al op een VPS van 5 dollar per maand. Je installeert met hetzelfde script, bij voorkeur als aparte gebruiker en niet als root. De documentatie beschrijft hoe je hem als service laat doordraaien na uitloggen.
In Docker. Het officiële image heet nousresearch/hermes-agent. Je maakt op de host een map aan voor je gegevens en koppelt die aan de container. Configuratie, API-sleutels, gesprekken, skills en geheugen staan dan buiten de container, zodat je het image kunt vervangen zonder iets kwijt te raken. Let op: in Docker werkt het update-commando van Hermes niet. Updaten doe je door een nieuw image te draaien. Details staan in de Docker-handleiding.
Een praktische tip uit diezelfde handleiding: gebruik geen browserconsole van je VPS-aanbieder om opdrachten te plakken. Sommige consoles maken van een dubbele punt een puntkomma, en dan klopt je opdracht niet meer. Log in via SSH.
Na de installatie: model, chat en skills
De setup-wizard (hermes setup) loopt alles in één keer met je door. Je kunt de onderdelen ook los instellen.
Eerst het model. Hermes werkt met veel aanbieders, waaronder OpenRouter, OpenAI, Nous Portal en een eigen endpoint. Met hermes model wissel je zonder iets aan de code te veranderen. Wie geen losse API-sleutels wil verzamelen voor zoeken, beeld en spraak, kan Nous Portal gebruiken: één abonnement voor ruim 300 modellen plus die extra gereedschappen.
Dan de chatkoppeling. Met hermes gateway setup koppel je Telegram, Slack, WhatsApp of een van de andere platforms. Pas dan kun je de agent een bericht sturen terwijl hij op een server draait.
Tot slot de skills. Bij een nieuwe installatie krijg je een set standaardvaardigheden mee. Extra skills haal je uit de Skills Hub. Hermes volgt daarbij de open standaard voor skills van agentskills.io.
Kom je van OpenClaw, Claude Code, Codex of Cursor? Dan kan de setup je instellingen, geheugen en skills overnemen. Hoe dat werkt en waar de twee agents verschillen, staat in Hermes Agent vs OpenClaw.
Beveiliging: deze instellingen sla je niet over
Een agent die opdrachten uitvoert op een server, moet je begrenzen. Hermes heeft daar drie lagen voor.
De eerste is goedkeuring van gevaarlijke opdrachten. Standaard staat die op "smart": een hulpmodel beoordeelt het risico, keurt duidelijk onschuldige opdrachten goed, weigert duidelijk gevaarlijke en legt twijfelgevallen aan jou voor. Reageer je niet binnen vijf minuten, dan gaat de opdracht niet door. Geplande taken weigeren gevaarlijke opdrachten standaard helemaal. Je kunt de controle uitzetten met een YOLO-modus, maar de documentatie raadt dat alleen aan in afgeschermde omgevingen.
De tweede is wie er met de agent mag praten. Bij chatkoppelingen leg je vast welke gebruikers toegang hebben. Zet dat goed voordat je de koppeling live zet, anders kan in theorie iedereen die je bot vindt opdrachten geven.
De derde is isolatie. Je kunt Hermes zijn opdrachten laten uitvoeren in een aparte container in plaats van direct op de server. Alle opties staan in de beveiligingsdocumentatie.
Wanneer zelf installeren, en wanneer niet
Zelf installeren is goed te doen als je vertrouwd bent met een terminal, SSH en een VPS. Voor uitproberen op je eigen laptop is het zelfs aan te raden: je ziet snel wat zo'n agent kan.
Zelf werk ik al een tijdje met Hermes Agent. Ik gebruik hem om bedrijven te automatiseren, tot en met complete bedrijven.
Het wordt anders zodra de agent aan je bedrijfsmail, je klantgegevens of je boekhouding moet. Dan gaat het om de vraag welke rechten hij krijgt, hoe je de server bijhoudt, wat er gebeurt als iets misgaat en wie dat in de gaten houdt. Wil je daar zelf geen tijd in steken, dan kun je Hermes Agent laten inrichten. Wij zetten de server in de EU op, koppelen de systemen en stellen de beveiliging af.
Veelgestelde vragen
Is Hermes Agent gratis?
Op welke systemen draait Hermes Agent?
Kan ik Hermes Agent in Docker draaien?
Welke AI-modellen kan ik met Hermes Agent gebruiken?
Waar vind ik de broncode van Hermes Agent?
“Een website is een investering, geen kostenpost. Als die investering je meer klanten oplevert dan hij kost, is het altijd de moeite waard.”
