乐于分享
好东西不私藏

Hermes Agent:自学习、插件化、跨平台的 AI 助手框架

Hermes Agent:自学习、插件化、跨平台的 AI 助手框架

项目概览
项目
内容
仓库地址
https://github.com/NousResearch/hermes-agent
完整名称
NousResearch/hermes-agent
简介
The agent that grows with you
主要语言
Python
许可证
MIT
创建时间
2025‑07‑22T22:22:28Z
最近一次提交
2026‑03‑29T07:46:03Z
Stars / Forks / Watchers
15794 / 1920 / 15794
Open Issues / PRs
944 / 595
核心功能概览
功能
说明
 自闭环学习
运行时自动记录错误、用户纠正、最佳实践,并在后续对话中检索使用
多平台网关
支持 Telegram、Discord、Slack、WhatsApp、 Signal、Email 等,统一 hermes gateway 接口
子代理 (sub‑agents)
可在独立进程/容器中并行执行耗时任务,降低 LLM Token 消耗
Cron 调度
内置自然语言任务计划(系统事件或子代理),支持精确定时或间隔执行 
Skill 系统
基于 agentskills.io 标准的插件化技能,用户可自定义工具、记忆、自动化脚本
完整 TUI / CLI
交互式终端 UI,支持多行编辑、快捷命令、历史回放、流式输出
迁移工具
hermes claw migrate 能一键导入 OpenClaw 的 SOUL、MEMORY、Skills 等
文档站点
https://hermes-agent.nousresearch.com/docs/ 提供快速上手、配置、开发者指南等
代码结构(关键目录)
  “`
   hermes/ # 主 Python 包,包含 CLI、gateway、工具、记忆、skill、cron 等核心模块
   scripts/ # 一键安装脚本 (install.sh) 
   .github/
   workflows/ # CI/CD:tests、docker‑publish、docs‑check、supply‑chain‑audit 等
   assets/ # UI Banner、图标等资源  
   docs/ (站点) # 完整文档,生成自 /docs 目录
   skills/ # 可插件化 Skill 目录(遵循 agentskills 标准)
   crontab/ / cron/ # Cron 调度实现
   context/ # 项目上下文文件(JSON/MD),在每次对话中自动加载
 “` 
活跃度 & 社区健康
指标
数据
 Stars
15 794 ★
Forks
1 920 🍴
Watchers
15 794 👀
最近 30 天提交
已获取前 5 条 commit SHA/消息
CI 通过率
最近 10 次 GitHub Actions 均成功(tests.yml, docker-publish.yml 等)
安全审计
supply-chain-audit.yml 自动检查供应链安全,未发现高危漏洞
社区渠道
Discord(活跃)、GitHub Discussions(已开启)
贡献指南
完整 CONTRIBUTING.md,提供 uv 环境快速上手

风险提示

  • Issue/PR 堆积:> 900 条未关闭 Issue、> 500 条 PR,说明项目迭代快但部分技术债未及时清理。建议关注 good first issue、help wanted 标签进行分流。
  • 文档同步:部分内部 API 文档仍在 docs/,新功能发布后需要手动更新,建议采用共享 Markdown 片段或自动化构建脚本。
推荐使用场景
场景
适配度
备注
 个人化 AI 助手
★★★★★
完整记忆、跨平台、可自行选择模型
团队内部自动化
★★★★☆
Cron + 子代理可实现定时报告、数据处理
研发实验平台
★★★★☆
支持 Docker、SSH、Daytona、Modal,成本低
开源社区贡献
★★★★☆
丰富的贡献指南、自动迁移工具
企业内部部署
★★★☆☆
需自行审计安全、权限、合规流程
改进建议(可直接写入 TODO)
  • Issue/PR 自动管理

    添加 stale Bot 自动标记长时间未响应的 Issue/PR。

    为关键 PR 开启 automerge(需 CI 通过)以降低积压。

  • 文档同步机制

    将 README 与站点文档抽取为共享 Markdown 模块,使用脚本在 CI 中同步。

  • 端到端 UI 测试

    引入 pexpect 或 expect 对 TUI 交互进行自动化回归,防止 UI 改动导致功能回退。

  • 依赖安全审计

     在 CI 中加入 pip-audit、npm audit,并在 PR 检查列表中展示结果。

  • 社区新手引导

    在 CONTRIBUTING.md 增设 “good first issue” 示例,降低上手门槛。

快速上手(示例)
“`     
   # 1️⃣ 一键安装
   curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
   # 2️⃣ 加载环境变量
   source ~/.bashrc # 或 source ~/.zshrc
   # 3️⃣ 启动交互式 TUI
   hermes 
   # 4️⃣ 启动多平台网关(以 Telegram 为例)
   hermes gateway setup # 按提示填写 Bot Token                           
   hermes gateway start  
 “` 
结语

Hermes Agent 是一个 自学习、插件化、跨平台的 AI 助手框架,代码质量高、CI 完备、社区活跃。唯一需要关注的是 Issue/PR 积压与文档同步,在企业或大规模团队使用前可先参考上述改进措施。