hermes-agent · Ashare

hermes-agent

Hermes Agent 自学习代理

开源开源项目Windows · macOS · Linux

带学习闭环的终端 AI 代理：自己沉淀技能、跨会话检索记忆，还能常驻云主机从 Telegram 指挥。适合把代理当长工用的人；代价是一键脚本会顺带拉起 Python、Node、FFmpeg 一整套依赖。

适合

想让代理长期驻留、跨会话积累经验并远程指挥的人：定时任务、定时报告、夜间备份这类无人值守场景。

不适合

只想本地问两句就走的人，装这一整套依赖不划算；也不适合不能接受代理在后台常驻并自动执行 cron 任务的机器。

详细介绍

Hermes Agent 是 Nous Research 做的终端代理，主打「会自己变强」：任务结束后自动沉淀技能，使用过程中改进技能，周期性提示自己持久化知识，还能用 FTS5 检索过去的会话。它不是绑在你笔记本上的聊天框——支持 local、Docker、SSH、Singularity、Modal、Daytona、Vercel Sandbox 七种终端后端，可以跑在一台 5 美元的 VPS 上，你从 Telegram 跟它说话。

两个入口要分清：hermes 开终端 TUI，hermes gateway 起消息网关（Telegram、Discord、Slack、WhatsApp、Signal、邮件），同一个网关进程全包。模型用 hermes model 切换，支持 Nous Portal、OpenRouter、OpenAI 和自建 endpoint，换模型不换代码。

代价是安装比较重：脚本会委托 PM 装 Python 3.14、Node.js、npm、ripgrep、FFmpeg 和一堆 Python 依赖，缺 Git 时还会往工具目录里放一份 Windows 版 Git。Windows 上杀软常把自带的 uv.exe 判成木马（Astral 的 Rust 包管理器，误报），要放行整个 bin 目录而不是单个文件——uv 每次升级哈希都变。

上手步骤

详细教程

上手步骤之外的具体做法：常见场景怎么配、命令怎么写、报错怎么处理。

按第一次上手会卡在哪讲：装完为什么命令找不到、终端与消息网关两个入口怎么选、模型怎么换、以及 Windows 上 uv.exe 被误杀怎么处理。

装完第一件事：刷新 shell

一键脚本装完，hermes 常常还是「command not found」。原因不是没装上，而是 PATH 没进当前 shell：

bashsource ~/.bashrc    # zsh 用户用 source ~/.zshrc
hermes              # 开始对话

两条路径的目录不一样，排查时别找错地方：

环境	安装位置
Linux / macOS / WSL2	`~/.hermes`
原生 Windows	`%LOCALAPPDATA%\hermes`
Termux	走 APT 包，不用桌面脚本

两个入口，别搞混

Hermes 有两条起手式，共用同一批斜杠命令：

hermes —— 终端 TUI：多行编辑、斜杠命令补全、可打断并改向、流式工具输出。
hermes gateway —— 消息网关：起一个进程，Telegram / Discord / Slack / WhatsApp / Signal / 邮件全接。

网关要两步：hermes gateway setup 配好平台，再 hermes gateway start，然后给机器人发消息。进去之后 /new、/reset、/model、/retry、/undo、/compress、/usage 这些命令两边通用，只有中断方式不同：终端是 Ctrl+C，消息端是 /stop。

换模型不用改代码

bashhermes model        # 选 provider 和模型
hermes tools        # 选启用哪些工具
hermes config set   # 改单个配置项
hermes doctor       # 出问题先跑它

支持 Nous Portal、OpenRouter、OpenAI 和自建 endpoint。不想一家家收 API Key（模型、搜索、生图、TTS、云浏览器），可以 hermes setup --portal 用 OAuth 登录 Nous Portal 一次搞定，随时 hermes portal info 看接了什么；网关是按后端开关的，不是全有或全无，仍可以自带 Key。

无人值守任务

内置 cron 调度器，结果可以投递到任意平台：日报、夜间备份、每周巡检，用自然语言写，跑完不用人盯。

Windows：uv.exe 被杀软隔离

这是最常见的假故障。Hermes 自带 Astral 的 uv 管理 Python 环境，ML 引擎常把「未签名 + 会下载安装」的 Rust 二进制判为威胁。

验证真伪：用 gh attestation verify 核对 GitHub 上的发布证明，再比对文件哈希。确认后给整个目录加白名单：

powershellAdd-MpPreference -ExclusionPath "$env:LOCALAPPDATA\hermes\bin"

按文件哈希加会在下次升级时失效。

适合谁

适合

不适合