Hermes Agent installeren: via de desktopapp of de terminal

Hermes Agent installeren kan op twee manieren: met de desktopapp voor Windows en Mac, of met één commando in de terminal. Je hoeft daarvoor geen ontwikkelaar te zijn. In deze handleiding laat ik je eerst de desktopapp zien en daarna de terminalvariant, met commando’s die je kunt kopiëren en plakken. Beide routes leiden naar dezelfde agent, met hetzelfde geheugen en dezelfde mogelijkheden.

De voorbeelden komen van onze eigen Hermes-installatie bij Voltti. De installatie-uitvoer en het opstartscherm zijn voor deze uitleg samengesteld; wat je ziet, hangt af van je versie en configuratie.

Waarom twee routes? De desktopapp is de snelste start als je zelden een terminal opent: downloaden, openen en je eerste vraag typen. De terminalvariant geeft je meer controle. Het is ook de basis als je de agent later op een aparte computer of server wilt laten draaien. Welke je ook kiest: de Hermes-documentatie beschrijft elke stap in detail.

Hermes installeren: desktopapp of terminal, met de pinguïn als gids — Twee routes naar dezelfde agent: de desktopapp of de terminal.

Wat heb je nodig voordat je begint?

Voor de desktopapp heb je Windows of een Mac met een Apple-chip nodig. Macs met een Intel-processor ondersteunt Hermes niet, ook niet via de terminal. De officiële installatiepagina zegt het letterlijk: “The macOS installer is Apple Silicon only.”

De terminalvariant werkt op Linux, macOS en Windows, via WSL2 of PowerShell. Op Linux en macOS heb je daarvoor onder meer Git en curl nodig. Python, Node.js en de andere onderdelen zet het installatiescript zelf klaar. Daarnaast heb je een AI-model nodig, via een account bij een provider of een eigen API-sleutel. In de desktopapp kun je eerst met een gratis proefmodel starten.

Hermes Desktop installeren (zonder terminal)

Het desktoppakket bevat alles wat de agent nodig heeft, ook Python en de andere onderdelen. Je hoeft dus niets via een zwart scherm met tekst te installeren. Zo ga je te werk:

Download het pakket voor jouw systeem van de Hermes-website.
Open het bestand. Op Windows doe je dat met App Installer, op een Mac open je de schijfkopie en sleep je Hermes naar de map Programma’s.
Start Hermes. Een korte begeleide chat helpt je met de eerste instellingen en draait op een gratis proefmodel.
Kies daarna het model waarmee je verder wilt werken.
Typ je eerste vraag en de agent antwoordt.

Voor dat model kun je inloggen bij een provider zoals Nous Portal. Eén account dekt dan het model én de ingebouwde tools, zoals zoeken op het web en afbeeldingen maken. Heb je al API-sleutels van bijvoorbeeld OpenRouter of Anthropic, dan kun je die ook invullen.

Vanaf dat moment draait alles in de app: gesprekken, bestanden en geheugen. Hoe je samen met een team werkt, beschrijven we in ons artikel over Hermes voor teams.

Wanneer kies je de terminalvariant?

Kies de terminalvariant als de agent altijd moet aanstaan, ook als je laptop dicht is. De desktopapp draait namelijk op de computer waar je achter zit. Via de terminal kun je de agent ook op een aparte minicomputer of server laten draaien. Wanneer zo’n aparte machine zinvol is, lees je in ons artikel over een eigen Linux-computer voor je AI-agent.

Daarna kun je de agent koppelen aan Google-gegevens, zoals we uitleggen in ons artikel over marketingdata ophalen met een AI-agent. Die koppeling kan de agent ook vanuit Hermes Desktop instellen, als de nodige tools en toegang beschikbaar zijn.

Je kunt de commando’s hieronder kopiëren en in je terminal plakken. Wacht steeds tot een stap klaar is voordat je doorgaat. Als iets mislukt, vertelt het installatiescript wat er ontbreekt. Meestal lost één extra commando dat het scherm zelf voorstelt het op.

hermes installeren op Linux

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

Hermes Agent Installer

→ Detected: Linux (arch) ✓ Managed uv found (uv 0.9.27) ✓ Python found: 3.11.15 ✓ Git 2.51.0 found ✓ C++ compiler found ✓ Node.js v26.14.0 found (Hermes-managed) ✓ Internet connectivity looks good → Cloning hermes-agent repository... → Creating virtual environment... → Installing dependencies...

┌─────────────────────────────────────────────────────────┐ │ ✓ Installation Complete! │ └─────────────────────────────────────────────────────────┘

📁 Your files:

Config: ~/.hermes/config.yaml API Keys: ~/.hermes/.env Data: ~/.hermes/cron/, sessions/, logs/ Code: ~/.hermes/hermes-agent/

🚀 Commands:

hermes Start chatting hermes setup Configure API keys & settings hermes config View/edit configuration hermes update Update to latest version

⚡ Reload your shell to use 'hermes' command:

source ~/.bashrc

Voorbeeld van installatie-uitvoer, samengesteld uit het installatiescript en controles van onze eigen installatie. De versienummers komen van een eerdere installatie. Het installatiescript zet nu zelf de juiste Python-versie klaar, dus je hoeft geen specifieke versie te installeren.

Na de installatie: model kiezen, controleren en bijwerken

Het installatiescript start de configuratiewizard meestal zelf. Wil je hem later opnieuw doorlopen, dan gebruik je hermes setup. De wizard vraagt welk model je wilt gebruiken en welke tools je aanzet. Daarna test je met hermes doctor of alles werkt. Die ingebouwde controle vertelt of je configuratie compleet is.

source ~/.bashrc   # op een Mac: source ~/.zshrc
hermes setup
hermes doctor

Op Windows kun je in plaats van de desktopapp ook de terminal gebruiken. Open PowerShell en voer dit commando uit de installatiehandleiding uit:

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

Heb je de commandoregelversie al geïnstalleerd? Met hermes desktop voeg je de desktopapp toe.

Het opstartscherm hieronder komt van onze eigen installatie op versie v0.21.1. Hermes krijgt vaak updates, dus jouw versie is waarschijnlijk nieuwer. De werkwijze blijft dezelfde. Een terminalinstallatie houd je bij met hermes update; de desktopapp werkt zichzelf bij. Wil je naar een andere computer verhuizen, maak dan eerst een back-up met hermes backup en zet die op de nieuwe machine terug met hermes import.

Geef de agent in het begin alleen de toegang die je eerste taak nodig heeft. In chatkanalen reageert de agent standaard alleen op mensen die je zelf toelaat, en riskante commando’s vragen eerst je goedkeuring. Meer over veilig werken met een AI-agent lees je op onze pagina over veiligheid en privacy.

hermes — eerste start na installatie

$ hermes


██╗  ██╗███████╗██████╗ ███╗   ███╗███████╗███████╗       █████╗  ██████╗ ███████╗███╗   ██╗████████╗
██║  ██║██╔════╝██╔══██╗████╗ ████║██╔════╝██╔════╝      ██╔══██╗██╔════╝ ██╔════╝████╗  ██║╚══██╔══╝
███████║█████╗  ██████╔╝██╔████╔██║█████╗  ███████╗█████╗███████║██║  ███╗█████╗  ██╔██╗ ██║   ██║
██╔══██║██╔══╝  ██╔══██╗██║╚██╔╝██║██╔══╝  ╚════██║╚════╝██╔══██║██║   ██║██╔══╝  ██║╚██╗██║   ██║
██║  ██║███████╗██║  ██║██║ ╚═╝ ██║███████╗███████║      ██║  ██║╚██████╔╝███████╗██║ ╚████║   ██║
╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝╚═╝     ╚═╝╚══════╝╚══════╝      ╚═╝  ╚═╝ ╚═════╝ ╚══════╝╚═╝  ╚═══╝   ╚═╝

┌─ Hermes Agent v0.21.1 (2026.9.7) · upstream ead7e91d ───────────────────────────────────────────────────┐
│                                     Available Tools                                                     │
│  ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣀⡀⠀⣀⣀⠀⢀⣀⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀     browser-use: browser_exec                                           │
│  ⠀⠀⠀⠀⠀⠀⢀⣠⣴⣾⣿⣿⣇⠸⣿⣿⠇⣸⣿⣿⣷⣦⣄⡀⠀⠀⠀⠀⠀⠀     clarify: clarify                                                    │
│  ⠀⢀⣠⣴⣶⠿⠋⣩⡿⣿⡿⠻⣿⡇⢠⡄⢸⣿⠟⢿⣿⢿⣍⠙⠿⣶⣦⣄⡀⠀     code_execution: execute_code                                        │
│  ⠀⠀⠉⠉⠁⠶⠟⠋⠀⠉⠀⢀⣈⣁⡈⢁⣈⣁⡀⠀⠉⠀⠙⠻⠶⠈⠉⠉⠀⠀     cronjob: cronjob_manage                                             │
│  ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣴⣿⡿⠛⢁⡈⠛⢿⣿⣦⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀     delegation: delegate_task                                           │
│  ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠿⣿⣦⣤⣈⠁⢠⣴⣿⠿⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀     file: patch, read_file, search_files, write_file                    │
│  ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⠉⠻⢿⣿⣦⡉⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀     memory: memory                                                      │
│  ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠘⢷⣦⣈⠛⠃⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀     process: process_manage                                             │
│  ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢠⣴⠦⠈⠙⠿⣦⡄⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀     (and 7 more toolsets...)                                            │
│  ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠸⣿⣤⡈⠁⢤⣿⠇⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀                                                                         │
│  ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠉⠛⠷⠄⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀     Available Skills                                                    │
│  ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣀⠑⢶⣄⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀     apple: apple-notes, apple-reminders, findmy +1 more                 │
│  ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣿⠁⢰⡆⠈⡿⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀     autonomous-ai-agents: claude-code, codex, computer-use +2 more      │
│  ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⠳⠈⣡⠞⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀     creative: architecture-diagram, ascii-video +8 more                 │
│  ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀     devops: sdlc-review                                                 │
│                                     email: email-inbox-triage, himalaya                                 │
│  glm-5.3 · Nous Research            media: gif-search, songsee, youtube-content                         │
│  /home/gebruiker                    note-taking: obsidian                                               │
│  Session: 20260909_203509_397644    productivity: airtable, box +12 more                                │
│                                     research: arxiv, competitor-news-monitor +2 more                    │
│                                     social-media: xurl                                                  │
│                                     software-development: codebase-inspection, dogfood, github +9 more  │
│                                     web: blocked-page-recovery                                          │
│                                                                                                         │
│                                     21 tools · 58 skills · /help for commands                           │
└─────────────────────────────────────────────────────────────────────────────────────────────────────────┘

Welcome to Hermes Agent! Type your message or /help for commands.
* Tip: Smart model routing can auto-route simple queries to a cheaper model.

# glm-5.3 | ctx -- [██████████] -- | 1s | 0s
❯

Het opstartscherm van een verse installatie: de banner, je model en sessie, de tools en skills die standaard actief zijn, en de prompt waarin je gewoon Nederlands typt.

Lukt de installatie niet?

Begin met hermes doctor. Die controle vertelt precies wat er ontbreekt en hoe je het oplost.

Meldt je terminal na de installatie dat het commando hermes niet bestaat? Herlaad dan je shell met source ~/.bashrc (op een Mac: source ~/.zshrc) of open een nieuw terminalvenster.

Krijg je de melding dat er geen API-sleutel is? Kies dan je provider en model met hermes model.

Mist er na een update een instelling? Voer dan hermes config check en daarna hermes config migrate uit.

Bij een mislukte stap toont het installatiescript de laatste regels en de plek van het volledige logbestand.

Wat kun je ermee?

Eén werkende installatie is het begin. Daarna groeit de agent met je mee. Het bewaart afspraken in het geheugen en bouwt skills voor terugkerende taken. Wil je de agent bereiken via een chatkanaal dat je team al gebruikt, zoals Slack, Discord of Telegram? Voer dan hermes gateway setup uit. Via MCP-servers, koppelingen met andere tools, kan de agent ook werken met bijvoorbeeld Google Search Console. Hoe dat groeipad eruitziet voor een bedrijf, beschrijven we op de pagina over de Hermes AI-agent voor bedrijven.

Twijfel je nog welke taak je de agent eerst geeft? In Hermes Agent uitgelegd lees je zes toepassingen voor bedrijven, en onze vergelijking van Hermes met ChatGPT en Copilot laat zien waar de verschillen zitten.

Wil je niet zelf installeren? Voltti installeert en geeft support op Hermes voor bedrijven in België en Nederland. Bekijk hoe een pilot verloopt of bespreek je vraag direct via de knop hieronder.

Veelgestelde vragen

01Moet ik kunnen programmeren om Hermes te installeren?

Nee. De desktopapp installeer je zonder terminal: downloaden, openen en starten. Bij de eerste start helpt een korte begeleide chat je op weg, op een gratis proefmodel. Voor de terminalvariant kopieer en plak je de commando’s uit dit artikel. Ontbreekt er iets, dan stelt het installatiescript zelf het commando voor dat het oplost.

02Op welke systemen draait Hermes?

De desktopapp werkt op Windows en op Macs met een Apple-chip. Hermes ondersteunt geen Macs met een Intel-processor, ook niet via de terminal. Via de terminal installeer je Hermes op Linux, macOS en Windows, met WSL2 of PowerShell. Op Android gebruik je het Hermes-pakket voor Termux. Het installatiescript zet zelf Python, Node.js en de andere onderdelen klaar.

03Wat kost Hermes?

De software zelf is open source en gratis. Je betaalt wel voor het AI-model dat de agent aandrijft: via een abonnement zoals Nous Portal of met API-sleutels van een provider naar keuze. Je kiest dat bij de configuratie. De desktopapp laat je eerst kennismaken via een gratis proefmodel. Met een lokaal model betaal je niet per vraag, maar heb je wel geschikte hardware nodig.

04Kan ik later van desktop naar een server verhuizen?

Ja. De agent bewaart configuratie, geheugen en skills in een vaste map. Maak een volledige back-up met hermes backup en zet die op de nieuwe machine terug met hermes import. Zo verhuis je de installatie zonder opnieuw te beginnen. Let op: een export van één profiel bevat bewust geen sleutels en is dus geen volledige back-up.

05Kan ik Hermes ook zonder internet gebruiken?

Voor de installatie en voor cloudmodellen heb je internet nodig. Wie volledig offline wil werken, koppelt een lokaal model via een eigen endpoint. Het model draait dan op je eigen hardware. Hoe dat werkt en wanneer het zinvol is, lees je in ons artikel over lokale en hybride AI-oplossingen voor bedrijven.

Klaar om met Hermes te starten?

Bespreek je pilot