Hermes Agent Source Code Study Guide

What Hermes Agent Source Code Study Guide does

This repository is a Chinese-language study guide to the internals of Hermes Agent, written for developers who want to read the source. It is organized in eight parts plus appendices: overall architecture and core concepts, the AIAgent conversation loop in run_agent.py, the tool system, the CLI, the messaging gateway, memory and state, skills, and advanced features.

Individual chapters cover the central tool registry and automatic tool discovery, the interactive setup wizard, configuration and credential handling across providers, the skin engine, gateway session management and platform adapters, SessionDB with SQLite FTS5 search, the memory tool, Honcho user modeling, the agentskills.io skills hub, the ACP adapter for VS Code, Zed and JetBrains, cron scheduling and the Atropos RL training environment. The appendices include a file index, a configuration reference and a glossary. A published site is linked from the repository.

Key features

• Architecture overview and core concepts chapters with module relationship diagrams
• Walkthrough of the AIAgent conversation loop and message flow
• Chapters on the tool registry, discovery and core toolset
• Coverage of the CLI, gateway, session database, memory tool and skills hub
• File index, configuration reference and glossary appendices

When to use it

• Learning how the Hermes Agent conversation loop works before contributing
• Finding which source file implements a gateway, tool or CLI feature
• Reading about Hermes Agent internals in Chinese

Who it is for: Chinese-reading developers who want to understand or contribute to the Hermes Agent codebase.

How it fits with Hermes Agent

It documents Hermes Agent itself, based on the v0.6.0 source, rather than extending it.

Note: The guide is written in Chinese and was last updated for Hermes Agent v0.6.0 on 2026-04-02.

FAQ