Hermes Agent
一句话简介
NousResearch 开源的 Python 智能代理框架,专注于大语言模型驱动的自主任务执行与对话交互。
标签
适用应用场景
- 构建基于LLM的对话式AI助手
- 实现自动化任务分解与多步推理
- 开发具备工具调用能力的智能代理
- 集成Hermes模型进行本地推理部署
README 中文摘要
Hermes Agent
由 Nous Research 开发的自进化 AI 智能体。它内置学习闭环:能从经验中创建技能、在使用中持续改进技能、定期将知识沉淀入库、可检索自身历史会话,并跨会话构建对用户的深层认知模型。运行环境灵活,可在 5 美元的 VPS、GPU 集群或空闲时几乎零成本的无服务器平台上运行;用户既能在本地终端使用,也能通过 Telegram 等聊天平台远程操控云端实例。
模型与厂商完全可选:支持 Nous Portal、OpenRouter、OpenAI、自定义端点等多种后端,可通过 hermes model 一键切换,无锁定风险。
核心特性
- 真正的终端界面:完整 TUI,支持多行编辑、斜杠命令自动补全、会话历史、中断重定向、流式工具输出。
- 全平台触达:单一网关进程即可接入 Telegram、Discord、Slack、WhatsApp、Signal 与 CLI,支持语音备忘录转写与跨平台会话延续。
- 闭环学习:智能体策展的记忆体系,周期性地主动归纳;复杂任务完成后自动生成技能,技能在使用中自我改进;基于 FTS5 的会话检索配合 LLM 摘要实现跨会话召回;集成 Honcho 的辩证式用户建模,并兼容 agentskills.io 开放标准。
- 定时自动化:内置 cron 调度器,可将日报、夜间备份、周度审计等任务以自然语言描述后投递到任意平台。
- 委托与并行:可派生隔离的子智能体处理并行工作流;支持通过 RPC 让 Python 脚本调用工具,将多步骤流水线折叠为零上下文的回合。
- 多终端后端:本地、Docker、SSH、Singularity、Modal、Daytona、Vercel Sandbox 共七种后端;Daytona 与 Modal 支持无服务器持久化,空闲时环境休眠、按需唤醒。
- 研究就绪:批量轨迹生成与轨迹压缩,便于训练下一代工具调用模型。
快速安装
Linux、macOS、WSL2、Termux:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Windows 原生环境(PowerShell):
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
安装脚本会处理所有依赖:uv、Python 3.11、Node.js、ripgrep、ffmpeg 以及一份便携的 Git Bash(MinGit,解压至 %LOCALAPPDATA%\hermes\git,无需管理员权限,与系统 Git 完全隔离)。安装完成后执行 hermes 即可开始对话。
若系统中已有 Git,安装程序会自动复用;Windows Defender 等杀毒软件可能误报 uv.exe,可通过 GitHub CLI 拉取官方 release 并验证 attestation 确认文件真实性,验证通过后将 %LOCALAPPDATA%\hermes\bin 加入白名单即可。
常用命令
hermes # 启动交互式 CLI
hermes model # 选择 LLM 厂商与模型
hermes tools # 配置启用的工具
hermes config set # 设置单项配置
hermes config get # 读取单项配置
hermes gateway # 启动消息网关(Telegram、Discord 等)
hermes setup # 运行完整配置向导
hermes claw migrate # 从 OpenClaw 迁移
hermes update # 升级到最新版本
hermes doctor # 诊断问题
如不想分别申请模型、搜索、图像生成、TTS、云浏览器等多套 API 密钥,可使用 Nous Portal:单一订阅覆盖 300+ 模型以及上述全部工具网关能力。执行 hermes setup --portal 一键完成 OAuth 登录、厂商切换与工具网关启用。
CLI 与消息平台命令对照
| 操作 | CLI | 消息平台 |
|---|---|---|
| 开始对话 | hermes |
运行 hermes gateway setup + hermes gateway start,向机器人发送消息 |
| 开启新会话 | /new 或 /reset |
/new 或 /reset |
| 切换模型 | /model [provider:model] |
/model [provider:model] |
| 设置人格 | /personality [name] |
/personality [name] |
| 重试/撤销 | /retry、/undo |
/retry、/undo |
| 压缩上下文 | /compress、/usage、/insights [--days N] |
/compress、/usage、/insights [days] |
| 浏览技能 | /skills 或 /<skill-name> |
/<skill-name> |
| 中断任务 | Ctrl+C 或发送新消息 |
/stop 或发送新消息 |
从 OpenClaw 迁移
hermes setup 首次运行时会自动检测 ~/.openclaw 并提示迁移;也可随时执行 hermes claw migrate(支持 --dry-run、--preset user-data、--workspace-target 等参数)导入 SOUL.md 人格文件、记忆条目、技能、命令白名单、消息平台配置、API 密钥与 TTS 资源。
贡献与社区
贡献者可使用标准安装脚本后,在 ${HERMES_HOME:-$HOME/.hermes}/hermes-agent 目录中以 uv pip install -e ".[all,dev]" 进行可编辑安装,并通过 scripts/run_tests.sh 运行测试。手动克隆时务必将虚拟环境创建在源码目录之外,避免被智能体自身的相对路径清理操作误删。完整开发规范参见官方文档中的 Contributing 指南。
文档与支持
官方文档站点提供 Quickstart、CLI 用法、配置、消息网关、安全、工具与工具集、技能系统、记忆机制、MCP 集成、cron 调度、上下文文件、架构说明、贡献指南、CLI 参考与环境变量完整索引。
许可证
本项目基于 MIT 协议开源。
摘要更新于 2026-08-24 00:32:22
· 原文 17574 字符
· md5 3b2cc2a36e7a…