Kenhuang Academy
  • English

      • Hermes Agent Tutorial

      Welcome to the Hermes Agent Tutorial. Based on the official Hermes Agent docs and the open-source NousResearch/hermes-agent project, this guide helps you master Nous Research's self-hosted, persistent-memory, self-improving open-source AI agent from scratch.

      Hermes Agent is not another chatbot or code-completion tool. It's a personal AI agent that runs on your own server, reaches you across many messaging platforms, and grows as you use it. Its tagline: "The AI agent that grows with you."

      Table of Contents

      Basics

      1. Introduction — Positioning, philosophy, the five pillars, and comparisons
      2. Architecture & Features — Agent loop, gateway, layered memory/skills/backends
      3. Installation & Usage — One-line install, hermes setup, first conversation

      Configuration

      1. Model Configuration — Nous Portal, OpenRouter, local vLLM, /model
      2. Tool System — 40+ built-in tools, hermes tools, execution backends, MCP

      Channels & Capabilities

      1. Message Channels — Telegram / Discord / Slack gateway setup
      2. Skills — SKILL.md, auto-generated skills, agentskills.io
      3. Memory System — SOUL / MEMORY / USER three-layer memory and retrieval

      Advanced

      1. Multi-Agent — Sub-agents, parallel workflows, Kanban orchestration
      2. Permissions & Security — Command approval, DM pairing, container isolation
      3. Slash Commands — /new, /model, /skills quick reference

      Practice

      1. Use Cases — Personal assistant, DevOps, research, automation
      2. Hands-on Practice — From install to a Telegram personal assistant
      3. Resources — Official docs, community, and further reading

      Learning Path

      StageGoalChapters
      Day 1Install and run your first chatIntroduction → Installation → Model Config
      Days 2–3Understand tools and memoryTools → Memory → Skills
      Week 1Connect platforms, automateChannels → Slash Commands → Multi-Agent
      OngoingSecurity and scaleSecurity → Use Cases → Practice

      Prerequisites

      • Basics of the terminal and Git
      • A Linux / macOS machine (or WSL2 / Termux)
      • At least one LLM access path: a Nous Portal account, an OpenRouter API key, or a local model

      Note: Hermes Agent iterates quickly, so commands and config keys may change between versions. This tutorial aims to track the official docs — when in doubt, defer to the official documentation.