hermes atlas
apr·2026 155·repos hermes·v0.10.0 ★ star this repo

anneheartrecord/hermes-agent-anatomy

hermes-agent源码解析

★ 48 langHTML updated2026-04-09

This project provides a systematic technical decomposition and architectural analysis of the Hermes Agent source code. It breaks down the framework's 334,000 lines of Python code into modular guides covering the core agent loop, tool registration, and multi-provider adapters. The documentation includes visual technical illustrations and a 13-dimension comparative study against other frameworks like Claude Code and OpenClaw. Users can leverage these docs to understand complex features such as context compression, RL training data collection, and 11-platform message gateway integration.

  • Detailed analysis of core agent cycles and iteration budget management
  • Deep dives into context compression and structured LLM summarization techniques
  • Technical breakdown of 8 memory backends and 11 message platform adapters
full readme from github

English

Hermes Agent 源码解剖

License Docs Language Lines AI

📖 在线阅读: https://anneheartrecord.github.io/hermes-agent-anatomy/

NousResearch/hermes-agent 是一个 33 万行 Python 代码的开源 AI Agent 框架。从 CLI 交互到 11 平台消息网关到 RL 训练数据采集,全部内置在一个单体仓库里。

这个仓库是对 hermes-agent 源码的系统化技术分析,逐模块拆解,配有大量手绘风格技术插图。最后一篇将 Hermes Agent、OpenClaw、Claude Code 三个框架放在一起做了 13 个维度的对比。

姊妹篇:Claude Code 源码解剖

文档目录

全景篇

文档 内容
01-全景图 Nous Research 背景、整体架构、代码规模、定位分析

核心模块篇

文档 内容
02-Agent 核心循环 AIAgent 类生命周期、IterationBudget、并行工具执行、消息清洗
03-Tool Registry ToolEntry 元数据、单例注册、异步桥接、handle_function_call 分发
04-多 Provider 适配 统一消息格式、Anthropic 适配器、凭证池化、OAuth 认证
05-上下文压缩 头尾保护、LLM 结构化摘要、Session 分裂、轨迹压缩
06-消息网关 GatewayRunner、SessionStore、11 平台适配器、Hooks 系统
07-Memory 与 RL 训练 8 种 Memory 后端、SQLite FTS5、批量轨迹生成、Skill 安全扫描

对比篇

文档 内容
08-三方对比 Hermes Agent vs OpenClaw vs Claude Code,13 个维度逐项拆解

关键数据

指标 数据
版本 v0.8.0
Python 文件 744 个
代码总量 ~334,661 行
核心依赖 openai / anthropic / httpx / rich / prompt_toolkit
Agent 循环上限 90 次迭代
内置工具 ~25 个核心 + MCP/插件扩展
消息平台 11 个
Memory 后端 8 种插件
凭证池策略 4 种

License

本仓库为技术分析文档,不包含 hermes-agent 源码本身。

MIT