Installatiegids

Hermes aan de praat krijgen

Hermes Agent v0.8.0 installeer je in ongeveer 60 seconden op Linux, macOS of WSL2. Eén curl-commando, en het installatiescript regelt uv, Python 3.11, Node.js, ripgrep en ffmpeg voor je.

checklist Systeemvereisten

javascript Node.js

Alleen git is nodig als vooraf — Python 3.11, Node.js v22, uv, ripgrep en ffmpeg worden door het script geïnstalleerd

computer OS

Linux, macOS, WSL2 op Windows, of Android via Termux. Native Windows wordt niet ondersteund.

memory RAM

Minimaal 2 GB RAM; meer als je lokale modellen draait

hard_drive Disk

~1 GB voor de agent, zijn venv, Node-modules en ingebouwde vaardigheden

extension Optional

Optioneel: Docker, SSH, Daytona, Singularity of Modal voor gesandboxte commando-uitvoering

wifi Network

Internetverbinding vereist voor hosted model-API's. Lokale modellen via een OpenAI-compatibel endpoint werken offline.

De one-liner uit de officiële docs. Aanbevolen voor de meeste gebruikers op Linux, macOS of WSL2. Installatiedocs arrow_forward

WSL2 (Windows)

Native Windows wordt niet ondersteund. Draai dit in een WSL2-shell na 'wsl --install'.

PS> curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

macOS / Linux / WSL2

Alleen git is nodig als vooraf — het installatiescript regelt uv, Python 3.11, Node.js v22, ripgrep en ffmpeg.

$ curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

verified Controleer je installatie

Draai de verificatiecommando's uit de officiële docs.

1
$ hermes version

Toont de geïnstalleerde versie (moet 0.8.0 of later zijn).

2
$ hermes doctor

Draait een diagnosecontrole — Python, uv, afhankelijkheden, configuratiebestanden en connectiviteit.

3
$ hermes status

Toont je huidige configuratie: modelprovider, ingeschakelde tools en gekoppelde gateways.

settings Initiële configuratie

Herlaad na installatie je shell en draai de drie setup-commando's uit de docs.

1

Kies een modelprovider

Draai 'hermes model' om een provider te kiezen. De README noemt Nous Portal, OpenRouter, z.ai/GLM, Kimi/Moonshot, MiniMax, OpenAI en custom endpoints. Anthropic en Mistral worden ook als afhankelijkheden meegeleverd.

2

Schakel de gewenste tools in

Draai 'hermes tools' om te configureren welke van de 47 ingebouwde tools zijn ingeschakeld. Je kunt ze later toevoegen of verwijderen.

3

Draai de volledige setup-wizard

Draai 'hermes setup' om door de complete wizard te lopen, inclusief API-keys en chat-gatewayverbindingen (Telegram, Discord, Slack, WhatsApp, Signal, e-mail).

4

Stuur een testbericht

Probeer 'hermes chat -q "Hallo! Welke tools heb je beschikbaar?"' — rechtstreeks uit de officiële quickstart.

.env — Configuratie staat in ~/.hermes/ — config.yaml voor hoofdinstellingen, .env voor API-keys, plus submappen voor sessies, logs, herinneringen, vaardigheden en cron-taken. Zie de env-vars referentie op hermes-agent.nousresearch.com/docs/reference/environment-variables.

cloud VPS / Server-deployment

Hermes draait op elke Linux VPS met 2 GB RAM en ~1 GB schijfruimte. Dezelfde one-liner werkt via SSH.

1

SSH naar je server

Elke Linux-distro werkt — Ubuntu, Debian, CentOS, Arch, etc.

$ ssh user@jouw-server-ip
2

Draai het installatiescript

Het script detecteert je distro automatisch, installeert Python 3.11 via uv, en zet alle afhankelijkheden op.

$ curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
3

Schakel een sandbox-backend in

Configureer op gedeelde infrastructuur een van de sandbox-backends (Docker, SSH, Daytona, Singularity of Modal) zodat de shell-commando's van Hermes geïsoleerd draaien. Zie de README voor backend-specifieke setup.

4

Stel je API-key in en start

Kies een modelprovider en start Hermes. Gebruik tmux of screen voor persistentie — het proces draait op de voorgrond.

$ hermes model && hermes

Tip — Voor een persistent daemon, draai Hermes in tmux/screen of schrijf een systemd unit file. Bekijk de officiële docs voor daemon-setup.

system_update_alt Hermes upgraden

De README documenteert een ingebouwde updater: 'hermes update'. Er is geen gepubliceerd PyPI-pakket of Docker-image, dus andere upgrade-paden gaan via git. Upgradegids arrow_forward

npm
$ hermes update
pnpm
$ cd ~/.hermes/hermes-agent && git pull && uv pip install -e ".[all]"
Git
$ curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
Docker
$ # Er is nog geen officieel Docker-image gepubliceerd

Zie github.com/NousResearch/hermes-agent/releases voor wat er in elke versie zit.

delete_forever Hermes verwijderen

Hermes installeert in ~/.hermes/hermes-agent/ en symlinkt de binary naar ~/.local/bin/hermes. Beide verwijderen kost twee commando's. Verwijderingsinstructies arrow_forward

npm
$ rm ~/.local/bin/hermes
pnpm
$ rm -rf ~/.hermes/hermes-agent
Git (Source)
$ rm -rf ~/.hermes/hermes-agent
Docker
$ # Geen officieel Docker-image om te verwijderen

Gebruikersdata verwijderen (optioneel)

Dit verwijdert je sessies, herinneringen, vaardigheden, cron-taken en API-keys. Maak eerst een back-up van wat je nodig hebt.

macOS/Linux $ rm -rf ~/.hermes
Windows PS> # Draai dit in je WSL-shell — native Windows wordt niet ondersteund

build Probleemoplossing

Uit de troubleshooting-tabel van de installatiedocs en veelvoorkomende fouten van het installatiescript. Meer troubleshooting-tips arrow_forward

Hulp nodig?

Join de Nous Research Discord voor installatie-ondersteuning en community-troubleshooting.

forum Join Discord menu_book Officiële installatiedocs
hub Integraties • article Blog • apps Showcase
❯

Blijf op de hoogte

Community-updates over Hermes Agent-releases, nieuwe vaardigheden en integraties. Geen spam, altijd opzegbaar.