Beginnen met Hermes

Hermes Agent is een open-source AI-agent van Nous Research waarmee je een AI-model niet alleen vragen kunt laten beantwoorden, maar ook daadwerkelijk taken kunt laten uitvoeren op een computer of server.

Het Hermes-onboardingproces doorlopen

Stap 1

Wanneer je voor het eerst inlogt op je Hermes-server, wordt gevraagd om eerst je wachtwoord te wijzigen. Doe dit direct; anders kun je niet verder. Gebruik je SSH en niet de VPS-console in het TransIP-controlepaneel? De SSH-verbinding met je server wordt dan nu direct verbroken. Verbind opnieuw om verder te gaan.

Afhankelijk van hoe snel je bent met opnieuw inloggen zie je nu eerst het Hermes-installatieproces; wacht dit proces rustig af.

  Hermes Agent
  ============

  Usage:    hermes

  Provider setup:
    - hermes model                 (pick a provider; the free Nous tier needs no                                                                                    API key)
    - hermes auth add <provider>   (sign in with an account or API key)
    - type /login inside the chat

  Note: Hermes can read and change any file the user running it can reach,
        and can use sudo if that user has it.

  Docs:     https://hermes-agent.nousresearch.com/docs/

Last login: Wed Oct  7 08:02:32 2026 from 217.21.253.1
starting Hermes Agent installer. For more information, go to: https://hermes-age                                                                                   nt.nousresearch.com/docs/getting-started/installation

┌─────────────────────────────────────────────────────────┐
│             ☤ Hermes Agent Installer                    │
├─────────────────────────────────────────────────────────┤
│  An open source AI agent by Nous Research.              │
└─────────────────────────────────────────────────────────┘

✓ prerequisites ok (git, curl)
✓ Hermes Agent cloned
→ Downloading uv 0.12.3 (linux-x64)
✓ uv ready (uv 0.12.3 (x86_64-unknown-linux-gnu))
✓ bootstrap Python ready; PM prepares the dependency environment
✓ uv ready (uv 0.12.3 (x86_64-unknown-linux-gnu))
  Installing dependencies (hash-verified via uv.lock):   node: unpacking

Stap 2

Wanneer de installatie klaar is, krijg je direct de onderstaande opties te zien. ‘Quick setup’ is aanbevolen door Hermes, maar dit pushed je naar de Nous Portal. We gaan ervan uit dat je je eigen server, AI-subscriptions en/of lokale modellen wil gebruiken en niet de diensten die Nous aanbiedt. Kies daarom voor ‘Full setup’.

How would you like to set up Hermes?
  ↑↓ navigate  ENTER/SPACE select  ESC cancel

   (○) Quick Setup (Nous Portal) — free OAuth login, no API keys, model + tools (recommended)
 → (●) Full setup — configure every provider, tool & option yourself (bring your own keys)
   (○) Blank Slate — everything off except the bare minimum; opt in to each capability

Stap 3

Je krijgt nu de optie om een LLM-provider te selecteren en hebt twee keuzes:

• Wil je een self-hosted model via Ollama gebruiken? Selecteer dan ‘Custom endpoint (enter URL manually)’ bijna onderaan. Je hebt hiervoor een adres nodig zoals http://<JE_SERVER_IP>:11434/v1. Als er om een API key wordt gevraagd, gebruik dan ‘ollama’ en wanneer om een model wordt gevraagd, zorg dan dat je de modelnaam exact overneemt van je Ollama-server.
• Gebruik je liever een van de beschikbare LLM-providers? Pak dan nu de OAuth / API-key gegevens van je favoriete LLM-provider erbij en selecteer de gewenste provider.

Select provider:
  ↑↓ navigate  ENTER/SPACE select  ESC cancel

 → (●) Nous Portal (Everything your agent needs, 300+ models with bundled tool use)
   (○) Fireworks AI (OpenAI-compatible direct model API)
   (○) OpenRouter (Pay-per-use API aggregator)
   (○) Mixture of Agents (named presets; aggregator acts after reference models)
   (○) NovitaAI (Cloud: Model API, Agent Sandbox, GPU Cloud)
   (○) LM Studio (Local desktop app with built-in model server)
   (○) Anthropic (Claude models via API key or Claude Code)
   (○) OpenAI ▸ (ChatGPT/Codex subscription or direct OpenAI API)
   (○) Qwen ▸ (Qwen Cloud / DashScope, Coding Plan, Token Plan & Qwen CLI OAuth)
   (○) xAI Grok ▸ (Direct API or SuperGrok / Premium+ OAuth)
   (○) Xiaomi MiMo (MiMo-V2.5 and V2 models: pro, omni, flash)
   (○) Tencent Hy ▸ (Hy4 / Hy3 via TokenHub & TokenPlan)
   (○) NVIDIA NIM (Nemotron models via build.nvidia.com or local NIM)
   (○) GitHub Copilot ▸ (GitHub token API or copilot --acp process)
   (○) Hugging Face Inference Providers
   (○) Google AI Studio (Native Gemini API)
   (○) Google Vertex AI (Gemini via GCP; OAuth2 service account or ADC, GCP billing/quotas)
   (○) DeepSeek (V3, R1, coder, direct API)
   (○) Z.AI / GLM (Zhipu direct API)
   (○) Kimi / Moonshot ▸ (Coding Plan, Moonshot global & China endpoints)
   (○) StepFun Step Plan (Agent / coding models via Step Plan API)
   (○) MiniMax ▸ (Global, OAuth Coding Plan & China endpoints)
   (○) Ollama Cloud (Cloud-hosted open models, ollama.com)
   (○) Arcee AI (Trinity models, direct API)
   (○) GMI Cloud (Multi-model direct API)
   (○) Kilo Code (Kilo Gateway API)
   (○) OpenCode ▸ (Zen pay-as-you-go or Go subscription)
   (○) AWS Bedrock (Claude, Nova, Llama, DeepSeek; IAM or API key)
   (○) Azure Foundry (OpenAI-style or Anthropic-style endpoint, your Azure AI deployment)
   (○) Vercel AI Gateway (Multi-model aggregator)
   (○) Actual Computer - hosted inference via api.actual.inc, or local offline inference via model.base_url in config.yaml
   (○) CommandCode — 20+ models via OpenAI-compatible API
   (○) CommandCode — Claude models via Anthropic Messages API
   (○) custom (direct API)
   (○) DeepInfra — 100+ open models, pay-per-use
   (○) Meta Muse Spark family (Meta Superintelligence Labs)
   (○) Nebius Token Factory — OpenAI-compatible inference
   (○) Ramp Router (router.com) — routes each request to the cheapest model that clears your quality bar
   (○) Upstage (Solar API)
   (○) Local models (run open models on this machine — no account or API key)
   (○) Custom endpoint (enter URL manually)
   (○) Reasoning effort for the current model...
   (○) Configure auxiliary models...
   (○) Leave unchanged

Select OpenAI provider:
  ↑↓ navigate  ENTER/SPACE select  ESC cancel  ← previous

 → (●) ChatGPT or Codex Subscription
   (○) OpenAI API

┌─────────────────────────────────────────────────────────┐
│             ☤ Hermes Agent Setup Wizard                │
├─────────────────────────────────────────────────────────┤
│  Let's configure your Hermes Agent installation.       │
│  Press Ctrl+C at any time to exit.                     │
└─────────────────────────────────────────────────────────┘

◆ Configuration Location
  Config file:  /home/transip/.hermes/config.yaml
  Secrets file: /home/transip/.hermes/.env
  Data folder:  /home/transip/.hermes
  Install dir:  /home/transip/.hermes/hermes-agent

  You can edit these files directly or use 'hermes config edit'
✓ Applied recommended defaults:
    Max iterations: 150
    Compression threshold: 0.50
    Run `hermes setup agent` later to customize.

◆ Inference Provider
  Choose how to connect to your main chat model.
     Guide: https://hermes-agent.nousresearch.com/docs/integrations/providers

No provider is set up yet — pick one below. (Nous Portal works without an API key.)

  Current model:    anthropic/claude-opus-4.6
  Active provider:  none



Not logged into OpenAI Codex. Starting login...


Signing in to OpenAI Codex...
(Hermes creates its own session — won't affect Codex CLI or VS Code)

To continue, follow these steps:

  1. Open this URL in your browser:
     https://auth.openai.com/codex/device

  2. Enter this code:
     J42P-LWL6I

No provider is set up yet — pick one below. (Nous Portal works without an API key.)

  Current model:    anthropic/claude-opus-4.6
  Active provider:  none


Custom OpenAI-compatible endpoint configuration:

API base URL [e.g. https://api.example.com/v1]: https://demo.transip.nl/v1
API key [optional]: *************************
Verified endpoint via https://inference.token-factory.ai.team.blue/v1/models (20 model(s) visible)

Select API compatibility mode:
  1. Auto-detect [current]
     Use Hermes URL heuristics; best for standard OpenAI-compatible endpoints.
  2. Chat Completions
     Use /chat/completions for standard OpenAI-compatible servers.
  3. Responses / Codex
     Use /responses for Codex-compatible tool-calling backends.
  4. Anthropic Messages
     Use /v1/messages for Anthropic-compatible endpoints.
Choice [1-4, Enter to keep current/detected]: 1
  API mode: auto-detect
  Available models:
    1. DeepSeek-V4-Flash
    2. GLM-5.3-Flash
    3. GLM-5.3
    4. DeepSeek-V4.1-Flash
  Select model [1-4] or type name: 4
Context length in tokens [leave blank for auto-detect]:
Display name [Inference.token-factory.ai.team.blue]:

Select reasoning effort:
  ↑↓ navigate  ENTER/SPACE select  ESC cancel  ← previous

   (○) minimal
   (○) low
 → (●) medium  ← currently in use
   (○) high
   (○) xhigh
   (○) max
   (○) ultra
   (○) Disable reasoning
   (○) Skip (keep current)

Select terminal backend:
  ↑↓ navigate  ENTER/SPACE select  ESC cancel  ← previous

   (○) Local - run directly on this machine (default)
   (○) Docker/Podman - isolated container with configurable resources
   (○) Modal - serverless cloud sandbox
   (○) SSH - run on a remote machine
   (○) Daytona - persistent cloud development environment
   (○) Vercel Sandbox - cloud microVM with snapshot filesystem persistence
   (○) Singularity/Apptainer - HPC-friendly container
 → (●) Keep current (local)

Stap 4

Vervolgens kun je kanalen kiezen voor communicatie met Hermes (en na het onboardingproces eventueel nog andere opties). Je bent vrij om een van de beschikbare opties te selecteren; Hermes begeleidt je door het configuratieproces en onder dit overzicht vind je een voorbeeld hoe dit eruitziet voor Telegram.

Gebruik de spatie-toets om de gewenste optie(s) te selecteren en ‘Enter’ om te bevestigen.

Select platforms to configure:
  ↑↓ navigate  SPACE toggle  ENTER confirm  ESC cancel  ← previous

 → [ ] 💬 Mattermost  (not configured)
   [ ] 📡 Signal  (not configured)
   [ ] 💬 Weixin / WeChat  (not configured)
   [ ] 💬 BlueBubbles (iMessage)  (not configured)
   [ ] 🐧 QQ Bot  (not configured)
   [ ] 💎 Yuanbao  (not configured)
   [ ] 🧩 A2A  (not configured)
   [ ] 🐝 Buzz  (not configured)
   [ ] 🐳 DingTalk  (not configured)
   [ ] 🎮 Discord  (not configured)
   [ ] 📧 Email  (not configured)
   [ ] 🪽 Feishu / Lark  (not configured)
   [ ] 💬 Google Chat  (not configured)
   [ ] 💬 IRC  (not configured)
   [ ] 💚 LINE  (not configured)
   [ ] 🔐 Matrix  (not configured)
   [ ] 🔔 ntfy  (not configured)
   [ ] 📱 iMessage via Photon  (not configured)
   [ ] 🔔 Raft  (not configured)
   [ ] 🔒 SimpleX Chat  (not configured)
   [ ] 💼 Slack  (not configured)
   [ ] 📱 SMS (Twilio)  (not configured)
   [ ] 💼 Microsoft Teams  (not configured)
   [●] ✈️ Telegram  (not configured)
   [ ] 💼 WeCom (Enterprise WeChat)  (not configured)
   [ ] 💼 WeCom Callback (self-built apps)  (not configured)
   [ ] 💬 WhatsApp  (not configured)

◆ Telegram
  How would you like to create your Telegram bot?

    [1] Automatic (recommended)
        Scan a QR code → confirm in Telegram → done.
        No token copy-paste needed.

    [2] Manual
        Create a bot via @BotFather yourself and paste the token.

Choice [1/2] [1]: 2


Create a bot via @BotFather on Telegram
Telegram bot token: **********************************************
✓ Telegram token saved

  🔒 Security: Restrict who can use your bot
     To find your Telegram user ID:
     1. Message @userinfobot on Telegram
     2. It will reply with your numeric ID (e.g., 123456789)

Allowed user IDs (comma-separated, leave empty for open access): 123456789

Use your user ID (123456789) as the home channel?
  ↑↓ navigate  ENTER/SPACE select  ESC cancel  ← previous

 → (●) Yes
   (○) No

Stap 5

Je krijgt nu een vraag welke Tools je wilt gebruiken. Hiervoor komt Hermes al met een vooraf gedefinieerde selectie. Je bent vrij deze naar wens aan te passen. Druk vervolgens op ‘Enter’ om verder te gaan.

Tools for 🖥️  CLI
  ↑↓ navigate  SPACE toggle  ENTER confirm  ESC cancel  ← previous

 → [✓] 🔍 Web Search & Scraping  (web_search, web_extract)
   [✓] 🌐 Browser Automation  (navigate, click, type, scroll)
   [✓] 💻 Terminal & Processes  (terminal, process)
   [✓] 📁 File Operations  (read, write, patch, search)
   [✓] ⚡ Code Execution  (execute_code)
   [✓] 👁️  Vision / Image Analysis  (vision_analyze)
   [ ] 🎬 Video Analysis  (video_analyze (requires video-capable model))
   [✓] 🎨 Image Generation  (image_generate)
   [ ] 🎬 Video Generation  (video_generate (text/image/reference))
   [ ] 🐦 X (Twitter) Search  (x_search (requires xAI OAuth or XAI_API_KEY))
   [✓] 🔊 Text-to-Speech  (text_to_speech)
   [✓] 📚 Skills  (list, view, manage)
   [✓] 📋 Task Planning  (todo_list)
   [ ] 📌 Kanban  (opt-in task board tools for this platform)
   [✓] 💾 Memory  (persistent memory across sessions)
   [ ] 🧩 Context Engine  (runtime tools from the active context engine)
   [✓] 🔎 Session Search  (search past conversations)
   [✓] 🔌 Connections  (remote connector tools and account authorization)
   [✓] ❓ Clarifying Questions  (clarify)
   [✓] 👥 Task Delegation  (delegate_task)
   [✓] ⏰ Cron Jobs  (create/list/update/pause/resume/run, with optional attached skills)
   [ ] 🎵 Spotify  (playback, search, playlists, library)
   [ ] 🤖 Yuanbao  (group info, member queries, DM)
   [✓] 🖱️  Computer Use (macOS/Windows/Linux)  (background desktop control via cua-driver)
   [ ] 🔌 A2A  (A2A (Agent-to-Agent) protocol v1.0 support for Hermes Agent — both directions of the open Linux Foundation standard for inter-agent communication.

Afhankelijk van je keuzes krijg je nu enkele vragen welke providers je voor verschillende tools wil gebruiken, bijvoorbeeld:

Choose a provider:
  ↑↓ navigate  ENTER/SPACE select  ESC cancel  ← previous

 → (●) Local Browser [★ recommended · free] — Headless Chromium, no API key needed
   (○) Lightpanda [free · local · no Chromium] — Zig headless browser spawned by Hermes, text-only (no screenshots)
   (○) Nous Subscription (Browser Use cloud) [subscription] — Managed Browser Use billed to your subscription  ★ via Nous Portal (login on select)
   (○) Camofox [free · local] — Anti-detection browser (Firefox/Camoufox)
   (○) Browser Use [free · local · cloud] — New SOTA web harness (CLI 3.0) [active]
   (○) Browserbase [paid] — Cloud browser with stealth and proxies
   (○) Firecrawl [paid] — Cloud browser with remote execution
   (○) Skip — keep defaults / configure later

Kies voor dit voorbeeld ‘Local Browser’. Deze optie gebruikt een headless browser: een browser zonder zichtbaar venster. Een desktopomgeving is daarvoor niet nodig. Ook andere browserbackends ondersteunen headless gebruik; controleer hun installatievereisten voordat je ze selecteert.

Doorloop de verdere toolconfiguratie en selecteer de gewenste providers. Kies eventueel ‘Skip’ om de configuratie later te voltooien.

Let op: Browser Use werkt enkel met een geïnstalleerde browser (zowel bij headless als in een normale GUI). 

Stap 6

Afhankelijk van de keuze welk communicatie-platform je gebruikt, krijg je nu de vraag welke tools je ervoor beschikbaar wilt stellen. Hieronder volgt een voorbeeld voor Telegram:

Tools for 📱 Telegram
  ↑↓ navigate  SPACE toggle  ENTER confirm  ESC cancel  ← previous

 → [✓] 🔍 Web Search & Scraping  (web_search, web_extract)
   [✓] 🌐 Browser Automation  (navigate, click, type, scroll)
   [✓] 💻 Terminal & Processes  (terminal, process)
   [✓] 📁 File Operations  (read, write, patch, search)
   [✓] ⚡ Code Execution  (execute_code)
   [✓] 👁️  Vision / Image Analysis  (vision_analyze)
   [ ] 🎬 Video Analysis  (video_analyze (requires video-capable model))
   [✓] 🎨 Image Generation  (image_generate)
   [ ] 🎬 Video Generation  (video_generate (text/image/reference))
   [ ] 🐦 X (Twitter) Search  (x_search (requires xAI OAuth or XAI_API_KEY))
   [✓] 🔊 Text-to-Speech  (text_to_speech)
   [✓] 📚 Skills  (list, view, manage)
   [✓] 📋 Task Planning  (todo_list)
   [ ] 📌 Kanban  (opt-in task board tools for this platform)
   [✓] 💾 Memory  (persistent memory across sessions)
   [ ] 🧩 Context Engine  (runtime tools from the active context engine)
   [✓] 🔎 Session Search  (search past conversations)
   [✓] 🔌 Connections  (remote connector tools and account authorization)
   [✓] ❓ Clarifying Questions  (clarify)
   [✓] 👥 Task Delegation  (delegate_task)
   [✓] ⏰ Cron Jobs  (create/list/update/pause/resume/run, with optional attached skills)
   [ ] 🎵 Spotify  (playback, search, playlists, library)
   [ ] 🤖 Yuanbao  (group info, member queries, DM)
   [✓] 🖱️  Computer Use (macOS/Windows/Linux)  (background desktop control via cua-driver)
   [ ] 🔌 A2A  (A2A (Agent-to-Agent) protocol v1.0 support for Hermes Agent — both directions of the open Linux Foundation standard for inter-agent communication.

Zoals je ziet is dit in essentie hetzelfde als voor de vraag welke tools je beschikbaar wil stellen in CLI. Je bent opnieuw vrij in je keuzes, maar een chatkanaal hoeft niet dezelfde rechten te hebben als de eigen terminal. Selecteer enkel wat je echt nodig hebt.

Stap 7

Tot slot vraagt de wizard of je anonieme informatie naar Nous (de makers van Hermes) wil sturen. Je bent vrij in je keuze.

Help improve Hermes?
Asking once more: an earlier version could save "No thanks" before you saw this question.
Shared metrics are bounded counters: activity, outcomes, error classes (with a
fixed-list reason when a memory write, compression, update or install fails),
model routes, token totals, feature use and coarse machine facts. A failed or
finished fresh install is noted on this machine and counted only if you opt in.
Never prompts, files, paths,
setting values or error text. Collection stays on this machine; sending to Nous is
a separate choice, and apart from that install note, data from before you opt in
is never sent.
Details: https://hermes-agent.nousresearch.com/docs/developer-guide/relay-shared-metrics
Change it any time: hermes setup telemetry
  ↑↓ navigate  ENTER/SPACE select  ESC cancel

   (○) Collect and send to Nous
   (○) Collect locally only
 → (●) No thanks

Daarmee is de setup compleet! Er wacht tot slot nog een commando, zie onder deze output.

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

📁 All your files are in ~/.hermes/:

   Settings:  /home/transip/.hermes/config.yaml
   API Keys:  /home/transip/.hermes/.env
   Data:      /home/transip/.hermes/cron/, sessions/, logs/

────────────────────────────────────────────────────────────

📝 To edit your configuration:

   hermes setup          Re-run the full wizard
   hermes setup model    Change model/provider
   hermes setup terminal Change terminal backend
   hermes setup gateway  Configure messaging
   hermes setup tools    Configure tool providers

   hermes config         View current settings
   hermes config edit    Open config in your editor
   hermes config set <key> <value>
                          Set a specific value

   Or edit the files directly:
   nano /home/transip/.hermes/config.yaml
   nano /home/transip/.hermes/.env

────────────────────────────────────────────────────────────

🚀 Ready to go!

   hermes              Start chatting
   hermes gateway      Start messaging gateway
   hermes doctor       Check for issues

✓ Shared metrics off. Change it any time with `hermes setup telemetry`.
✓ Gateway service already installed
✓ Hermes Agent install complete. Run: hermes
→ Reload your shell to use hermes: open a new terminal, or run: source ~/.bashrc

Voer inderdaad het aanbevolen commando uit:

source ~/.bashrc

Daarmee is het onboardingproces afgerond en kun je direct in je gekozen communicatiekanaal met Hermes chatten!

Verbinden met het Hermes-dashboard vanaf je eigen computer

Je gebruikt het dashboard van een Hermes-server zonder desktopomgeving via de browser op je eigen computer. Een SSH-tunnel stuurt het verkeer versleuteld door naar de server. Voor deze VPS zijn twee terminalvensters nodig: een SSH-sessie op de server en een terminal op je eigen computer.

Stap 1

Verbind met je server via SSH. Gebruik dezelfde Linux-user als bij de configuratie van Hermes.

Stap 2

Start het dashboard op de server:

hermes dashboard --host 127.0.0.1 --port 9119 --no-open

--host bindt het dashboard aan de lokale interface van de server
--port kiest poort 9119 en 
--no-open voorkomt dat Hermes een browser op de server probeert te openen. 

Laat deze sessie open; het dashboard draait hier op de voorgrond.

Stap 3

Open een tweede terminal op je eigen computer, bijvoorbeeld PowerShell, Terminal of WSL. Maak daarin de SSH-tunnel:

ssh -N -o ExitOnForwardFailure=yes -L 127.0.0.1:9119:127.0.0.1:9119 -p 12345 username@203.0.113.10

-N opent geen remote shell
-L koppelt de lokale poort 9119 aan de dashboardpoort op de server. 
De eerste 127.0.0.1 voorkomt dat andere computers op je netwerk de tunnel gebruiken. 
-o ExitOnForwardFailure=yes stopt het commando als de poortkoppeling niet lukt. 
-p bepaalt de SSH-poort.

Vervang in dit commando:

• 12345 door het poortnummer dat je gebruikt voor SSH-verbindingen. Heb je het poortnummer niet aangepast? Dan gebruik je -p 22 (of laat je het weg).
• username door de gebruikersnaam waarmee je met je server verbindt.
• 203.0.113.10 door het IP-adres of een (sub)domeinnaam die naar je server verwijst, bijvoorbeeld hermes.voorbeeld.nl.

Laat ook deze terminal open. Het commando toont normaal geen verdere output zolang de tunnel actief is.

Stap 4

Open http://127.0.0.1:9119 in de browser op de computer waarop de tunnel draait. Je komt nu in het Hermes-dashboard terecht.

Het Hermes-dashboard gebruiken

Het dashboard openen

Bij de hierboven gebruikte loopbackconfiguratie open je het dashboard via je SSH-tunnel zonder een apart gatewaytoken in te voeren. Laat het dashboardproces en de tunnel draaien zolang je het dashboard gebruikt.

Het dashboard beheert instellingen, API-keys, skills, sessies en kanalen. Lees meer in de officiële dashboarddocumentatie.

Chatten met Hermes via het dashboard

Klik op ‘Chat’ (1) en voer je vraag of opdracht in. Deze pagina gebruikt de Hermes-TUI, de tekstinterface die ook in je terminal beschikbaar is (via het commando hermes). De chat toont naast antwoorden ook toolactiviteiten en vragen om bevestiging.

Gebruik ‘Sessions’ (2) of simpelweg het overzicht aan de rechterkant (3) om eerdere gesprekken te bekijken. Browsersessies en gesprekken via Telegram hebben hun eigen gespreksgeschiedenis.

Skills toevoegen en inschakelen

Skills zijn instructiebestanden met kennis en werkwijzen voor specifieke taken. Tools voeren de daadwerkelijke acties uit. Een skill verleent niet zelfstandig extra toegangsrechten.

Klik op ‘Skills’ om geïnstalleerde skills te bekijken en in of uit te schakelen. Gebruik ‘Browse hub’ om nieuwe skills te zoeken. Controleer de bron en inhoud voordat je een skill installeert. Start daarna een nieuwe chatsessie om de wijziging te gebruiken.

Via de terminal toon je de geïnstalleerde skills met:

hermes skills list

Lees de handleiding voor het gebruik van skills voor zoeken, installeren en het aanroepen van een skill in een gesprek.

Hermes beveiligen

Hermes voert acties uit met de rechten van de Linux-user waaronder het draait. Met de lokale terminalbackend leest en wijzigt de agent bestanden die voor die user toegankelijk zijn. Geef Hermes daarom alleen toegang tot de systemen en gegevens die voor je taken nodig zijn.

• Gebruik een afzonderlijke Linux-user zonder onnodige sudo-rechten. Draai Hermes niet als root (dit is de default in onze images).
• Beperk toegestane gebruikers per communicatiekanaal en schakel alleen benodigde tools in.
• Bewaar API-keys en bottokens zorgvuldig. Lees onze handleiding over veilig met credentials omgaan in Linux.
• Controleer skills en instructies uit externe bronnen. Prompt injection is een poging om de agent via aangeleverde inhoud andere instructies te laten volgen. Een securityscan geeft geen garantie tegen zulke instructies.
• Houd het dashboard op 127.0.0.1 en gebruik de SSH-tunnel voor toegang.

Controleer dependencies op bekende kwetsbaarheden:

hermes security audit

Deze audit controleert ondersteunde dependencies van Hermes, plugins en bepaalde MCP-servers. Het is geen volledige audit van je Linux-server, toegangsrechten of prompts. Lees ook de beveiligingsdocumentatie van Hermes.

Scan geïnstalleerde hub-skills afzonderlijk:

hermes skills audit

Bekijk de documentatie over skillscans voor de reikwijdte en beperkingen.

Een nieuw communicatiekanaal koppelen

Gebruik de gatewayconfiguratie om later bijvoorbeeld Telegram, Discord of WhatsApp toe te voegen:

hermes setup gateway

Selecteer het platform en volg de instructies voor authenticatie en toegestane gebruikers. Gebruik dezelfde Linux-user als tijdens de eerdere configuratie.

Configureer vervolgens welke tools op het kanaal beschikbaar zijn:

hermes tools

Herstart de geïnstalleerde gatewayservice om de wijzigingen te laden:

hermes gateway restart

De webinterface biedt hiervoor ook de pagina ‘Channels’. Verstuur na de configuratie een testbericht vanaf een toegestaan account.

Een lokaal model via Ollama gebruiken

Ollama draait taalmodellen op je eigen hardware. Kies een lokaal model als je de modelverwerking op je eigen infrastructuur wilt houden. Externe tools, gekoppelde diensten en afzonderlijk ingestelde hulpmodellen hebben hun eigen gegevensstromen.

De installatie van Ollama valt buiten deze handleiding. Hiervoor verwijzen we naar de officiële Ollama-documentatie. De benodigde RAM, opslag en eventuele GPU-capaciteit hangen af van het model.

Stap 1

Verbind via SSH met je Hermes-server. Voor dit voorbeeld draait Ollama op dezelfde server.

Stap 2

Controleer welke modellen lokaal geïnstalleerd zijn:

ollama list

Noteer de exacte naam van het gewenste lokale model. Kies een model dat tool calling ondersteunt en vermijd een cloudmodel als lokale verwerking je doel is.

Stap 3

Open de Hermes-modelkeuze:

hermes model

Selecteer ‘Custom endpoint (enter URL manually)’ en geef deze API-base-URL op:

http://127.0.0.1:11434/v1

Laat de API-key leeg bij standaard lokaal Ollama. Selecteer het geïnstalleerde model of voer de exacte modelnaam in. Laat de contextlengte automatisch detecteren, tenzij je die bewust hebt ingesteld.

Stap 4

Start een nieuwe Hermes-chat. Herstart daarnaast de gatewayservice als je het model via communicatiekanalen gebruikt:

hermes gateway restart

Als alternatief configureert een recente Ollama-versie de integratie interactief met:

ollama launch hermes

Bekijk de officiële Ollama-integratie met Hermes voor deze optie.

Een ander AI-model gebruiken

Gebruik de interactieve modelkeuze om je standaardprovider en model te wijzigen:

hermes model

Selecteer de provider, doorloop zo nodig de authenticatie en kies een beschikbaar model. Start een nieuwe chatsessie en herstart de gatewayservice als je de wijziging ook op communicatiekanalen wilt gebruiken.

Voor een modelwisseling binnen een lopend gesprek gebruik je:

/model

Dit is een chatcommando; voer het in Hermes in, niet in de Linux-shell. Controleer na de selectie welk model actief is. Beschikbare modellen en functies hangen af van je provider, account en endpoint. Lees meer over de ondersteunde modelproviders.

Hermes-troubleshooting en beheer

Voer de onderstaande commando’s op je Hermes-server uit, onder dezelfde Linux-user als tijdens de configuratie. De officiële commandoreferentie beschrijft de beschikbare opties.

Algemene troubleshoot

Start simpelweg een hermes-chatsessie in de VPS-console of via SSH:

hermes

Vertel Hermes welk probleem je ervaart en wat de eventuele foutmeldingen zijn en vraag het zelf het probleem te onderzoeken. 

Hermes updaten

hermes update

Status controleren

hermes status
hermes gateway status

Het eerste commando toont de algemene status; het tweede controleert de messaging gateway.

Configuratie controleren

hermes doctor

Voor automatische reparaties van ondersteunde problemen:

hermes doctor --fix

--fix probeert herstel uit te voeren. Controleer de resterende meldingen; deze optie herstelt niet iedere configuratiefout.

Logs bekijken

hermes logs
hermes logs errors
hermes logs gateway --follow

--follow toont nieuwe gatewaymeldingen terwijl ze binnenkomen. Stop met Ctrl + C. Verwijder gevoelige gegevens voordat je logs deelt.

Gateway herstarten

hermes gateway restart

Dit herstart de geïnstalleerde messaging gatewayservice. Het dashboardproces staat hier los van.

In deze handleiding heb je Hermes geconfigureerd, het dashboard via een SSH-tunnel geopend en geleerd hoe je skills, modellen en communicatiekanalen beheert. Gebruik de status- en diagnosecommando’s om problemen gericht te onderzoeken.