Hermes Agent

NousResearch/hermes-agent 访问 GitHub ↗
🔤 Python ★ 235791 ⑂ 0 daily #6 (+896) 抓取 2026-08-25

一句话简介

NousResearch 开源的 Python 智能代理框架,专注于大语言模型驱动的自主任务执行与对话交互。

标签

  • 人工智能
  • 智能代理
  • 大语言模型
  • 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…