:::warning Content Under Development

This page is still being written. Some sections may be incomplete or subject to change.

:::

Hermes Agent: A NocoBase Assistant That Learns as You Use It

Hermes Agent is a self-hosted open-source AI Agent — it automatically distills each successful operation into reusable skill documents, getting smarter the more you use it. After connecting it to NocoBase, you can not only build and manage systems using natural language, but also let it gradually learn your business conventions and preferences.

What Is Hermes Agent

Hermes Agent is developed by Nous Research (GitHub 35.7k Stars), with the core philosophy of "getting smarter the longer you use it." Unlike other AI Agents, Hermes has a complete closed-loop learning mechanism:

• Cross-session memory — Based on full-text search and LLM summarization, able to recall conversation context from weeks ago
• Automatic skill distillation — After each successful complex task completion, automatically creates reusable skill documents
• Continuous self-improvement — Skills are continuously refined through repeated use, becoming more precise over time
• 400+ model support — Compatible with mainstream LLM providers, not locked to a specific model

Hermes supports 8 platforms including Lark, Telegram, Discord, and Slack, and can also be used directly in the terminal.

:::tip Tip

Hermes Agent runs on your own server, with all data and memory stored locally — ideal for scenarios with data security requirements.

:::

Why Choose Hermes Agent

If you're deciding which AI Agent to use for operating NocoBase, here are the scenarios where Hermes fits best:

• Long-term maintenance of the same system — Hermes' memory mechanism means it understands your business better over time, no need to re-explain context each time
• Team requires self-hosting — Data stays completely local, never passes through third-party cloud services
• Need standardized operating procedures — Hermes' automatically distilled skill documents can serve as your team's operation manual
• Prefer terminal operations — Hermes natively supports CLI interaction, suitable for technical teams' daily use

How It Connects

Hermes Agent works with NocoBase in the following way:

You (Lark / Telegram / Terminal / ...)
  |
  └─→ Hermes Agent
        |
        ├── NocoBase Skills (enables Agent to understand NocoBase configuration system)
        |
        ├── NocoBase CLI (executes create, modify, deploy, and other operations)
        |
        └── Memory & Skill Documents (automatically distilled, continuously reused)
              |
              └─→ NocoBase Service (your business system)

Unlike other Agents, Hermes updates its memory and skill documents after each operation. This information is stored locally and automatically reused in subsequent operations.

Prerequisites

Before starting, make sure you have the following environment ready:

• A server running Hermes Agent (Linux / macOS, Python 3.10+)
• Node.js >= 22 (for running NocoBase CLI and Skills)
• If you already have a NocoBase instance, AI capabilities are evolving rapidly. The minimum required version is NocoBase 2.1.0, and we recommend updating to the latest version.

Installing Hermes requires just one command:

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

:::warning Note

Hermes Agent requires self-deployment and maintenance. If you prefer a zero-configuration out-of-the-box experience, consider OpenClaw (one-click Lark deployment) or WorkBuddy (hosted by Tencent).

:::

Quick Start

One-Click AI Installation

Copy the prompt below to Hermes Agent, and it will automatically complete NocoBase CLI installation, initialization, and environment configuration:

Help me install NocoBase CLI and complete initialization: https://docs.nocobase.com/ai/ai-quick-start.md (please read the linked content directly)

Manual Installation

npm install -g @nocobase/cli
nb init --ui

The browser will automatically open a visual configuration page, guiding you to install NocoBase Skills, configure the database, and start the application. For detailed steps, see Quick Start.

After installation is complete, run nb env list to confirm the environment status:

nb env list

Confirm the output shows the configured environment and its running status.

FAQ

Related Links

• NocoBase CLI — Command-line tool for installing and managing NocoBase
• NocoBase Skills — Domain knowledge packages installable into AI Agents
• AI Building Quick Start — Build NocoBase applications from scratch with AI
• Hermes Agent GitHub — Hermes Agent source code and documentation
• OpenClaw + NocoBase — The world's most popular open-source AI Agent, one-click Lark deployment
• WorkBuddy + NocoBase — Multi-platform remote control of NocoBase via WeCom, Lark, and DingTalk