把 Hermes Agent 当成一个可拆解、可迁移的技术产品来学习。

这不是一份普通文档目录，而是一张学习地图：从源码结构、主循环、工具系统到交互层，帮你建立对执行型 Agent 的完整心智模型。

先看架构图浏览学习导览

Learning SurfaceSource ↗

Agent Corerun_agent.py

Tool Bridgemodel_tools.py

Registrytools/registry.py

UX Layercli.py · gateway/run.py

当前推荐Hermes 不是会调工具的聊天机器人，而是一个 runtime。

Guided Start

先告诉我你想怎么学，我给你一条最短路径。

Aha Moment推荐 15 分钟

你会先建立一个“执行闭环”心智模型。

Hermes 不是会调工具的聊天机器人，而是一个 runtime。

先看架构图再进入学习导览

先用架构图建立全局地图

再读导览，把主循环、工具系统、交互层串起来

最后决定你要深入哪一条主线

Why this site

与其零散记文件名，不如先建立一套执行闭环视角。

Hermes 最值得学的不是“它支持多少能力”，而是它怎样把模型、工具、会话与产品体验组织成同一个系统。

Core Tracks

三条主线，覆盖一个 Agent runtime 的关键骨架。

01Runtime Loop

主循环与模型协作

看懂 prompt 组装、消息清洗、provider 适配、tool result 回写如何形成稳定执行闭环。

run_agent.py · prompt_builder.py · context_compressor.py

推荐优先阅读

02Tool System

工具注册、门控与调度

理解 registry、toolset、schema、check_fn、MCP 与插件如何被统一组织和安全执行。

model_tools.py · toolsets.py · tools/registry.py

03Product Layer

CLI、Gateway 与长期协作体验

理解 CLI、Gateway、Session、Memory、Todo、Cron 如何共同组成长期协作体验。

cli.py · gateway/run.py · hermes_state.py · cron/*

Pathways

按学习路径推进，而不是按目录迷路。

先建整体心智模型

先从架构总览出发，理解 Hermes 为什么不是“会调工具的聊天机器人”，而是一个 runtime。

再沿执行闭环深入

顺着主循环、工具系统、交互层一路看，避免按文件夹硬啃源码导致失焦。

最后提炼可迁移模式

把 provider 抽象、toolset、session、memory、cron 这些工程套路迁移到你自己的 Agent 项目。

Portable Patterns

真正该带走的是这些工程方法。

内部统一消息格式，边界适配不同 provider
工具不是函数清单，而是带 schema / check_fn / toolset 的运行时能力
上下文压缩更像交接协议，而不是摘要
CLI 与 Gateway 共用同一 agent core，但承担不同交互职责

Next Step

如果你想自己做一个 mini Hermes，这里就是你的起点。

从最小主循环、最小工具系统、最小 session store 开始，再逐步长出 memory、skills 与 cron。

查看完整学习路径

风格