hermes agent 支持二次开发,需版本≥v2.4.0、启用开发者模式(环境变量/配置文件/cli参数)、验证[dev]日志及调试端点,并可通过hermes dev shell和自定义python模块扩展功能。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您希望对Hermes Agent进行功能定制、逻辑修改或集成私有系统,则需确认其是否支持二次开发并正确启用开发者模式。Hermes Agent 作为 MIT 协议开源项目,原生支持完整二次开发流程
一、确认源码可访问与版本兼容性
Hermes Agent 所有核心代码托管于 GitHub 公共仓库,v2.4.0 起正式引入插件热加载、工具注册接口、内存调试钩子等开发者友好机制。低版本(v2.3.x 及以下)不支持动态插件注册与运行时内存快照功能。
1、执行 hermes version 命令,确认输出版本号不低于 v2.4.0。
2、运行 git clone https://github.com/NousResearch/hermes-agent.git 获取最新主干源码。
3、检查本地 ~/.hermes/ 目录下是否存在 dev_mode_enabled 文件或 ENABLE_DEV_MODE=true 环境变量配置项。
二、启用开发者模式的三种方式
开发者模式激活后,Hermes Agent 将启用调试日志、内存状态导出、插件热重载、LLM 工具调用链路追踪等能力,是二次开发的前提条件。
1、通过环境变量启用:在启动前执行 export ENABLE_DEV_MODE=true,再运行 hermes chat。
2、通过配置文件启用:编辑 ~/.hermes/config.yaml,在顶层添加字段 dev_mode: true,保存后重启进程。
3、通过 CLI 参数启用:直接运行 hermes --dev-mode chat "测试",该模式仅对本次会话生效,不写入持久配置。
三、验证开发者模式是否生效
成功启用后,Agent 将在标准输出中打印包含 [DEV] 前缀的初始化日志,并开放 /debug/memory 和 /debug/plugins 两个本地 HTTP 调试端点(默认监听 127.0.0.1:8081)。
1、启动 Hermes 后观察终端首行日志,确认出现 [DEV] Loaded plugin registry with 47 tools 类似提示。
2、执行 curl http://127.0.0.1:8081/debug/memory | jq '.working_memory.size',返回数字结果即表示调试端点可用。
3、运行 hermes plugin list,输出应包含 dev_tools、memory_inspector 等内置开发专用插件。
四、进入开发者交互环境
开发者模式下,CLI 提供专属命令集用于实时干预运行时行为,无需重启即可修改工具注册、注入调试断点、查看记忆快照。
1、启动交互式开发终端:hermes dev shell。
2、在 shell 中输入 help 查看可用指令,包括 mem dump、tool reload、llm trace on 等。
3、执行 mem dump --format=json > /tmp/hermes-mem-$(date +%s).json,导出当前工作记忆结构用于离线分析。
五、构建首个自定义开发模块
基于已启用的开发者模式,可立即创建可热加载的 Python 模块,用于扩展 Agent 行为逻辑,无需重新编译或打包。
1、在 ~/.hermes/dev_modules/ 目录下新建 logger_hook.py。
2、编写内容:导入 globalAgent 对象,调用 globalAgent.on("task_start", lambda t: print(f'[DEV] Task launched: {t.name}'))。
3、保存后执行 hermes dev module load logger_hook,终端将实时输出后续所有任务启动事件。











