Hermes Agent: wat het is, hoe je het installeert en configureert

Claude Code, Codex, Cursor, OpenClaw—elk van deze AI-agents heeft zijn eigen rol. Als je een agent nodig hebt die op je server draait, je tussen sessies door onthoudt en je op Telegram antwoord geeft terwijl je in een taxi zit, dan past Hermes Agent bij die rol.

Hermes Agent is een open project van Nous Research, en het is veel eenvoudiger te installeren dan veel mensen denken. Hieronder lees je wat het is, hoeveel het kost, hoe je het installeert op Windows, macOS of Linux, en hoe je er een model en een Telegram-bot aan koppelt. Alles is gebaseerd op de officiële documentatie.

Wat is Hermes Agent in gewone taal?#

Hermes hoort in dezelfde categorie als Claude Code of Codex: het is een AI-agent die niet alleen antwoorden schrijft, maar ook bestanden opent, terminalopdrachten uitvoert en een browser gebruikt. Het verschil zit in de opzet: Claude Code is gekoppeld aan Anthropic-modellen, terwijl Hermes met elke modelprovider werkt—from Claude en GPT tot lokale modellen die op je hardware draaien.

Het project is jong: de GitHub-repository is aangemaakt op 22 juli 2025. Toch heeft het per 22 augustus 2026 meer dan 234.000 sterren en 47.000 forks, waarmee het een van de snelst groeiende open projecten in deze categorie is. De code is volledig open onder de MIT-licentie: je kunt hem lezen, aanpassen en zonder royalty's in je producten gebruiken.

Twee concrete mechanismen vormen de basis van deze “zelfverbetering”: vaardigheden en geheugen. Vaardigheden zijn procedures die de agent na complexe taken opschrijft en de volgende keer toepast. Geheugen is een bestand met feiten over jou en je omgeving dat bij elk nieuw gesprek wordt geladen. Beide mechanismen komen hieronder aan bod in een aparte sectie.

Waarin verschilt Hermes Agent van Claude Code en Codex?#

De belangrijkste verschillen staan in deze tabel:

De tabel maakt het belangrijkste duidelijk. Claude Code is geschikt voor taken waarvoor het sterkste model nodig is en die in een repository plaatsvinden—Anthropic biedt hier nog steeds de beste combinatie van model en tools. Hermes is bedoeld voor situaties waarin je een agent nodig hebt die “altijd aan” staat: hij draait op een server, doet elke ochtend iets volgens een schema, antwoordt je op Telegram en onthoudt het gesprek van gisteren.

Als je basistools vergelijkt, zijn er aparte gidsen over Claude Code installeren, wat Codex van OpenAI is en het landschap van AI-codeertools in 2026.

Hoeveel kost Hermes Agent in 2026?#

De eenvoudigste optie is Nous Portal, het eigen abonnement van de Hermes-ontwikkelaars. Het omvat meer dan driehonderd modellen en ook kant-en-klare diensten: zoeken op internet, afbeeldingen genereren, spraaksynthese en een cloudbrowser. Per 22 augustus 2026 zijn de abonnementen:

De tweede optie, die veel mensen over het hoofd zien, is dat je helemaal geen nieuw abonnement hoeft af te sluiten. Hermes kan via OAuth aanmelden—dat wil zeggen, via een account dat je al hebt. ChatGPT- en Codex-abonnementen, Claude Max, SuperGrok van xAI, Qwen, MiniMax en GitHub Copilot worden ondersteund. Kies een provider tijdens de configuratie, bevestig de aanmelding in je browser en betaal vervolgens precies wat je daarvoor al betaalde.

De derde optie is je eigen API-sleutels gebruiken. Anthropic, OpenAI, Google, DeepSeek, Z.AI, Kimi, Alibaba en ongeveer twaalf andere providers: voer een sleutel in en het gebruik wordt rechtstreeks bij hun account in rekening gebracht.

De vierde optie kost geen geld, maar vereist wel hardware: een lokaal model via Ollama of LM Studio. Dit werkt als je een krachtige computer hebt en geen gegevens naar buiten wilt sturen. Er is één voorwaarde: het model moet een contextvenster van minstens 64.000 tokens hebben, anders weigert Hermes ermee te starten—de agent heeft genoeg werkgeheugen nodig voor lange taken.

De betaalvoorwaarden voor buitenlandse diensten komen hier niet aan bod—dat is een apart onderwerp met eigen regels, besproken in deze gids met Claude Code als voorbeeld.

Hermes Agent installeren op Windows#

Als je niet vertrouwd bent met de terminal, begin dan met het installatieprogramma. Op hermes-agent.nousresearch.com staan downloadknoppen voor macOS 12+, Windows 10/11 en Linux. Het gedownloade bestand installeert beide apps tegelijk: de opdrachtregeltool hermes en Hermes Desktop—een gewoon venster met chat, bestanden en instellingen.

Als je gewend bent aan opdrachten, installeer Hermes dan via PowerShell:

1. Open PowerShell

   Druk op Win, typ PowerShell en open het. Beheerdersrechten zijn niet nodig.

2. Voer het installatieprogramma uit

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

   Het script downloadt alles wat het nodig heeft: Python 3.11, Node.js 22, de pakketbeheerder uv, ripgrep en ffmpeg. Als je Git niet hebt, installeert het een eigen geïsoleerde MinGit-build, die apart wordt opgeslagen en geen invloed heeft op systeemprogramma's.

3. Start de terminal opnieuw en controleer de installatie

   hermes doctor
   

   De opdracht toont wat is geïnstalleerd, wat ontbreekt en hoe je dat kunt oplossen. Als je groene vinkjes ziet, is alles geïnstalleerd.

Met deze installatiemethode worden bestanden opgeslagen in %LOCALAPPDATA%\hermes. Als je WSL2 gebruikt, werkt de Linux-opdracht uit de volgende sectie daar ook—kies wat je het handigst vindt.

Hermes Agent installeren op macOS en Linux#

Hermes installeer je met één opdracht—op een laptop of een server. Dit is het hele proces:

1. Controleer of Git is geïnstalleerd

   git --version
   

   Als de opdracht een versienummer teruggeeft, ga dan verder. Controleer op Linux ook of curl en xz-utils aanwezig zijn: installeer ze op Debian en Ubuntu met sudo apt install curl xz-utils.

2. Voer het installatieprogramma uit

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

   Het script kloont de repository naar ~/.hermes/hermes-agent, maakt een virtuele omgeving aan en installeert de opdracht hermes in ~/.local/bin. Voor een server zonder grafische omgeving en zonder browserautomatisering kun je aan het einde bash -s -- --skip-browser toevoegen.

3. Herlaad de shell en start Hermes

   source ~/.zshrc   # op macOS; op Linux vaker: source ~/.bashrc
   hermes
   

Als je Hermes als root installeert, komen de bestanden in systeempaden terecht—/usr/local/lib/hermes-agent en /usr/local/bin/hermes—wat handig is voor een server die door meerdere accounts wordt gebruikt. Instellingen, sleutels en geheugen blijven in de persoonlijke map ~/.hermes van elke gebruiker staan.

Een opmerking over Hermes Desktop op Linux: om de app te bouwen op Debian en Ubuntu heb je de compilers uit het pakket build-essential nodig (sudo apt install build-essential). En als je Hermes met de opdracht hebt geïnstalleerd, heb je helemaal geen apart installatieprogramma nodig—voer hermes desktop uit en de app start met je bestaande instellingen, sessies en vaardigheden.

Een model koppelen aan Hermes Agent#

Het model is de motor van Hermes: de agent denkt niet zelfstandig, maar maakt verbinding met het model dat je kiest. De eerste stap na de installatie is dus kiezen waarmee hij verbinding maakt:

hermes model

De configuratiewizard vraagt om een provider, aanmeldmethode en model. Er zijn veel opties; de belangrijkste zijn:

Als je Nous Portal kiest, doet één opdracht alles tegelijk:

hermes setup --portal

De opdracht opent een aanmeldpagina in je browser. Nadat je de aanmelding hebt bevestigd, wordt Nous ingesteld als provider en wordt Tool Gateway ingeschakeld—zoeken op internet, afbeeldingen genereren en spraaksynthese zonder aparte sleutels voor elke dienst.

Hermes slaat sleutels en instellingen apart op; het is belangrijk dit vanaf het begin te begrijpen. Geheimen—API-sleutels en tokens—worden opgeslagen in ~/.hermes/.env. Gewone instellingen staan in ~/.hermes/config.yaml. Je hoeft deze bestanden niet handmatig te bewerken: hermes config set zet elke waarde automatisch in het juiste bestand:

Vind handleidingen voor tools in de Ailoot-documentatie

De volledige configuratiewizard is hermes setup. Deze heeft drie modi: snelle configuratie via Nous Portal, volledige configuratie waarbij je elke provider en tool zelf doorloopt, en Blank Slate—een schone installatie waarin alles behalve de essentiële onderdelen is uitgeschakeld, zodat je alleen inschakelt wat je nodig hebt.

Controleren of Hermes Agent werkt#

Start na het kiezen van een model een gesprek:

hermes          # klassieke interface
hermes --tui    # moderne interface, met muisondersteuning en pop-upvensters

De welkomstbanner toont het geselecteerde model, de ingeschakelde tools en vaardigheden. Vraag vervolgens niet “hallo, wie ben je?”—geef de agent een taak met een zichtbaar resultaat: “toon me de vijf grootste mappen op de schijf” of “bekijk de huidige map en vertel me welk bestand het hoofdbestand van het project is.” Als de agent een terminalopdracht uitvoert en een zinvol antwoord terugstuurt, werkt de basisconfiguratie.

De laatste controle betreft sessies. Sluit het gesprek af en keer terug:

hermes --continue   # of korter: hermes -c

Je moet weer in hetzelfde gesprek terechtkomen. Hiermee controleer je of de sessiegegevens naar schijf worden geschreven—de bot en geplande taken zijn daar later van afhankelijk.

Als iets niet werkt, volg dan deze volgorde: hermes doctor (algemene diagnose), hermes model (model en aanmelding opnieuw controleren), hermes setup (de configuratie opnieuw opbouwen), hermes sessions list en hermes --continue (sessies controleren), hermes gateway status (gatewaystatus). Met deze reeks kun je in een paar minuten van “alles is kapot” naar een duidelijke situatie gaan.

Wat zijn vaardigheden en geheugen in Hermes Agent?#

Een Hermes-vaardigheid is een bestand SKILL.md met een naam, beschrijving en stapsgewijze procedure: hoe je een document samenstelt, een pull request opent of een mailing voorbereidt. De agent leest korte beschrijvingen van alle vaardigheden en laadt de volledige tekst pas wanneer de taak erbij past—zo maken honderd geïnstalleerde vaardigheden niet elk verzoek groter. De standaard is open, agentskills.io, en dezelfde bestanden werken ook in andere agents.

Vaardigheden staan in de map ~/.hermes/skills/. Ze komen daar op drie manieren terecht: een basisset wordt samen met de app geïnstalleerd, kant-en-klare vaardigheden kunnen uit de catalogus worden toegevoegd met hermes skills install, en na complexe taken schrijft de agent zelf nieuwe vaardigheden. Elke vaardigheid wordt automatisch een slash-opdracht: installeer de gif-search-vaardigheid en /gif-search werkt in elke chat. Installatie uit de catalogus wordt op veiligheid gecontroleerd, zodat de procedure van iemand anders geen schadelijke opdrachten binnenbrengt.

Geheugen is nog eenvoudiger. Er zijn twee bestanden in ~/.hermes/memories/: MEMORY.md—de eigen notities van de agent over zijn omgeving en conclusies, maximaal 2.200 tekens—en USER.md—je profiel: hoe de agent op je moet reageren, wat je wel en niet prettig vindt, maximaal 1.375 tekens. Aan het begin van elk gesprek worden beide bestanden aan de systeemprompt toegevoegd, zodat de agent je al kent. De limieten zijn bewust streng: het geheugen dijt niet uit en de agent bepaalt wat hij bewaart en weglaat.

Deze twee onderdelen—vaardigheden en geheugen—vormen samen het Second Brain: een agent die context onthoudt en procedures verzamelt en daardoor elke week merkbaar beter werkt dan op de dag dat hij werd geïnstalleerd. Lees voor advies over het kiezen van deze vaardigheden en het voorkomen dat je agent een opslagplaats voor van alles wordt deze gids met Claude Code als voorbeeld—de principes zijn hetzelfde.

Hermes Agent koppelen aan Telegram#

Telegram is het populairste kanaal van Hermes en de integratie is goed ontwikkeld: tekst, spraakberichten met transcriptie, afbeeldingen en bestanden, en antwoorden in groepen. Dit is het proces:

1. Maak een bot met BotFather

   Open @BotFather in Telegram, stuur /newbot, kies een naam en een unieke gebruikersnaam die eindigt op bot. Je ontvangt een token zoals 123456789:ABCdef...—dit is de sleutel van je bot, dus bewaar hem als een wachtwoord. Als het token uitlekt, trek het dan in door /revoke naar dezelfde BotFather te sturen.

2. Zoek je gebruikers-ID op

   Zoek je numerieke Telegram-ID op, bijvoorbeeld 123456789. Dit is het nummer van je account; verwar het niet met je gebruikersnaam. Je hebt het nodig voor de toegangslijst.

3. Start de gateway-configuratiewizard

   hermes gateway setup
   

   Selecteer Telegram en plak je token en ID. De wizard slaat de instellingen voor je op. Je kunt dit ook handmatig doen met twee regels in ~/.hermes/.env: TELEGRAM_BOT_TOKEN=... en TELEGRAM_ALLOWED_USERS=123456789.

4. Start de gateway

   hermes gateway
   

   De bot is binnen enkele seconden online. Stuur hem een bericht en controleer het antwoord.

Toegang is standaard gesloten: de bot reageert alleen op ID's in de lijst. Je kunt een nieuwe persoon een koppelingscode geven; die werkt een uur en verloopt daarna. De lijst met openstaande en goedgekeurde gebruikers is beschikbaar met hermes pairing list.

Bij groepschats is er één valkuil die mensen vaak vergeten. Telegram-bots hebben standaard de privacymodus ingeschakeld: in een groep ziet een bot alleen opdrachten en antwoorden op zijn eigen berichten. Schakel de modus uit via @BotFather (Bot Settings - Group Privacy) om hem alles te laten lezen, of maak de bot eenvoudigerweg groepsbeheerder.

Standaard haalt de gateway zelf berichten op bij de Telegram-servers—dat is prima voor een thuiscomputer of server die altijd aanstaat. Voor cloudplatforms die de machine in slaapstand zetten wanneer er geen inkomend verkeer is, bestaat de webhookmodus: Telegram stuurt berichten dan naar jouw adres.

Wat kan Hermes Agent nog meer na de installatie?#

Dit kun je inschakelen, in deze volgorde:

1. Geplande taken. De gateway heeft een ingebouwde planner: “Maak elke ochtend om 8 uur een nieuwsoverzicht over mijn onderwerpen en stuur het naar me op Telegram.” Stel het schema in met een gewone zin en de resultaten verschijnen in dezelfde chat.
2. Hermes Desktop. Met de opdracht hermes desktop open je de app voor macOS, Windows en Linux met dezelfde agent: streamingantwoorden, bestandsvoorbeelden naast de chat, documenten slepen en neerzetten en een contextteller. Sessies worden gedeeld—je kunt in de terminal beginnen en verdergaan in het venster.
3. Webpaneel. hermes dashboard opent in de browser een paneel voor kanalen, geheugen, webhooks en profielen. Handig wanneer Hermes op een server draait.
4. Subagents. Je kunt een grote taak uitbesteden aan geïsoleerde hulpagents—elk heeft een eigen gesprek en terminal en gebruikt daardoor jouw context niet op.
5. Spraak. De spraakmodus werkt in de terminal, Telegram en Discord—je kunt een taak dicteren en een gesproken antwoord krijgen.
6. Code-editor. Via het ACP-protocol koppelt Hermes aan VS Code, Zed en JetBrains als agent die rechtstreeks in de editor werkt.

Je kunt tools één voor één in- en uitschakelen met hermes tools, zodat de agent niet alles hoeft mee te dragen. Als het tijd is om naar een andere machine te verhuizen, bundelt hermes backup de volledige installatie in een archief en pakt hermes import dat op de nieuwe locatie uit.

Voor wie is Hermes Agent geschikt en wie kan beter wachten?#

Het is zinvol Hermes te installeren zodra je weet wat je een agent wilt laten doen: documenten doorzoeken, een prototype bouwen, correspondentie beheren of ochtendoverzichten voorbereiden. De tool zelf is niet het belangrijkste—het gaat om de taken die je hem geeft. Daarover is er een aparte gids met taken voor een AI-agent.

In twee gevallen past Hermes mogelijk niet. Ten eerste, als je verwacht dat je je kunt aanmelden en dat het dan meteen werkt: Hermes moet worden geïnstalleerd en aan een model worden gekoppeld. Dat kost maar één opdracht, maar je moet nog steeds de terminal openen. Ten tweede, als je geen geschikt model hebt en niet wilt uitzoeken hoe een abonnement of API-sleutels werken.

Alle anderen kunnen het best klein beginnen: installeer Hermes, kies een model, voer één probleemloos gesprek en voeg daarna een Telegram-bot toe—pas daarna volgen schema's en subagents.

Wat vragen mensen nog meer over Hermes Agent?#

Meer bronnen zijn beschikbaar op Ailoot.