[Github发现] Hermes Agent – 多平台接入的通用 AI 编程代理框架

Hermes Agent 是 NousResearch 开源的一个 AI 编程代理框架，slogan 是”The agent that grows with you”。43.4k Stars、5.6k Fork 的高热度背后，是一个功能相当完整的通用 AI Agent 平台，支持多 LLM 提供商、多种即时通讯平台接入以及可扩展的记忆和工具系统。

GitHub 仓库目前保持 43.4k Stars、5.6k Fork，有 917 个 open issues、1.5k 个 open PRs，3,559 次提交，活跃度相当高，项目基于 MIT 许可证开源。

相关链接

• GitHub 仓库：https://github.com/nousresearch/hermes-agent
• 官方网站：https://hermes-agent.nousresearch.com
• 文档：https://docs.hermes-agent.dev

Hermes 是什么

Hermes Agent 本质上是一个通用 AI 编程代理运行时。它不是针对某一款 IDE 或某一个代码平台设计的，而是把 AI 代理需要的基础能力（记忆、工具调用、错误恢复、平台接入）打包成一套可配置的框架，开发者可以接入自己的 LLM 提供商、定义自己的工具集、连接自己需要的平台。

框架用 Python 编写，核心设计围绕”agent + tools + memory”三大块展开。它和 OpenClaw 在设计上有些相似之处——比如借鉴了 OpenClaw 的 failover 错误分类系统，在 API 调用失败时能做智能的模型切换和重试。

核心功能

多 LLM 提供商支持

Hermes Agent 内置了对多种 LLM 提供商的统一接入层：

• Nous Portal：Nous 自家平台
• OpenRouter：支持接入上百种模型
• OpenAI 兼容接口：可接入任意 OpenAI API 兼容的后端
• Hugging Face：支持 HF Inference API

框架内置了智能 failover 机制——当一个模型或提供商出现 rate limit、账单超限、认证失败等情况时，会自动切换到备用模型，保证任务不中断。

Gateway：多平台消息接入

hermes-agent 的 Gateway 模块支持将 AI 代理接入多种即时通讯平台：

• Discord
• Slack
• Telegram
• WhatsApp
• iMessage（通过 BlueBubbles macOS 服务器）
• SMS

接入后，用户可以直接在日常沟通工具里和 AI 代理对话，代理能访问代码库、执行工具、返回结果。

记忆系统（Hindsight）

hindsight 是 Hermes Agent 的记忆插件，支持：

• 长期记忆的存储和检索（retain/recall）
• 按 token 量和消息量配置保留策略
• 支持 structured JSON 格式存储
• 支持多 Session 累积和去重
• 可配置保留哪些对话、忽略哪些

工具系统

Hermes Agent 内置了丰富的工具集，涵盖：

• 终端工具：执行 shell 命令、文件操作
• 浏览器工具：网页搜索、内容抓取
• MCP 工具：通过 Model Context Protocol 扩展工具集
• 代码分析工具：代码补全、调试辅助

也支持用户自定义工具，通过插件接口接入。

Structured Error Classification

Hermes Agent 内置了一套智能错误分类系统 FailoverReason，支持 14 种错误类型：auth、billing、rate_limit、overloaded、server_error、timeout、context_overflow、model_not_found 等。遇到 API 错误时系统能自动判断原因并采取对应恢复策略（重试、切换凭证、压缩上下文、切换模型）。

快速部署

Docker（推荐）

docker pull nousresearch/hermes-agent:latest
docker run -d -p 8000:8000 -v ~/.hermes:/root/.hermes nousresearch/hermes-agent:latest

Homebrew

brew tap nousresearch/hermes-agent
brew install hermes-agent

Nix

nix run github:nousresearch/hermes-agent

从源码安装

git clone https://github.com/nousresearch/hermes-agent.git
cd hermes-agent
pip install -e .
hermes --version

配置和使用

Hermes Agent 支持多 Profile 配置，可以同时维护多套互不干扰的代理配置：

# 创建新 profile
hermes profiles create work

# 在指定 profile 下运行
hermes run --profile work

# 查看代理状态
hermes status

连接 Gateway 平台（以 Telegram 为例）：

hermes gateway add telegram
# 按提示配置 Bot Token
hermes gateway run telegram

适用人群

• AI 应用开发者：需要一套现成的 Agent 运行时，不想从零搭基础设施
• 独立开发者：想要一个在即时通讯工具里随时可用的 AI 编程助手
• AI 研究者：想实验不同 LLM 提供商和 prompt 策略的效果
• 团队：需要多用户、多平台接入的企业 AI 助手场景

总结

Hermes Agent 是一个功能相当完整的开源 AI Agent 框架，43.4k Stars 的热度印证了社区对这类通用 Agent 运行时的大量需求。它的多平台接入和多 LLM 提供商支持特别适合需要灵活切换模型或接入内部 IM 工具的场景，加上 Hindsight 记忆系统和智能错误恢复机制，是一个值得关注的开源 Agent 基础设施选项。