Hermes v2026.3.12 - 更新日志

# Hermes Agent v0.2.0 (v2026.3.12) **发布日期：** 2026年3月12日 > 自 v0.1.0（初始预发布基础版）以来的首个 tagged 版本。在短短两周多的时间里，Hermes Agent 从一个内部小项目发展成为一个功能齐全的 AI 代理平台——这得益于社区贡献的爆发。本版本合并了 **216 个拉取请求**，来自 **63 位贡献者**，解决了 **119 个问题**。 --- ## ✨ 主要亮点 - **多平台消息网关** — 支持 Telegram、Discord、Slack、WhatsApp、Signal、Email (IMAP/SMTP) 和 Home Assistant 平台，具备统一的会话管理、媒体附件和按平台配置工具的功能。 - **MCP (模型上下文协议) 客户端** — 原生 MCP 支持，包含 stdio 和 HTTP 传输、重连、资源/提示词发现以及采样（服务器发起的 LLM 请求）。( [#291](https://github.com/NousResearch/hermes-agent/pull/291) — @0xbyt4, [#301](https://github.com/NousResearch/hermes-agent/pull/301), [#753](https://github.com/NousResearch/hermes-agent/pull/753) ) - **技能生态系统** — 涵盖 15 多个类别的 70 多个捆绑和可选技能，提供技能中心用于社区发现、按平台启用/禁用、基于工具可用性的条件激活以及先决条件验证。( [#743](https://github.com/NousResearch/hermes-agent/pull/743) — @teyrebaz33, [#785](https://github.com/NousResearch/hermes-agent/pull/785) — @teyrebaz33 ) - **集中式提供商路由器** — 统一的 `call_llm()`/`async_call_llm()` API 取代了之前分散在视觉、摘要、压缩和轨迹保存等模块中的提供商逻辑。所有辅助消费者都通过单一代码路径路由，并自动解析凭证。( [#1003](https://github.com/NousResearch/hermes-agent/pull/1003) ) - **ACP 服务器** — 通过代理通信协议标准实现 VS Code、Zed 和 JetBrains 编辑器集成。( [#949](https://github.com/NousResearch/hermes-agent/pull/949) ) - **CLI 皮肤/主题引擎** — 数据驱动的视觉定制：横幅、旋转器、颜色、品牌标识。内置 7 款皮肤 + 自定义 YAML 皮肤。 - **Git 工作树隔离** — `hermes -w` 在 git 工作树中启动隔离的代理会话，以安全地在同一仓库上并行工作。( [#654](https://github.com/NousResearch/hermes-agent/pull/654) ) - **文件系统检查点与回滚** — 在破坏性操作前自动创建快照，可通过 `/rollback` 恢复。( [#824](https://github.com/NousResearch/hermes-agent/pull/824) ) - **3,289 个测试** — 从几乎零测试覆盖率到涵盖代理、网关、工具、cron 和 CLI 的全面测试套件。 --- ## 🏗️ 核心代理与架构 ### 提供商与模型支持 - 集中式提供商路由器，含 `resolve_provider_client()` + `call_llm()` API ( [#1003](https://github.com/NousResearch/hermes-agent/pull/1003) ) - Nous Portal 作为设置中的一级提供商 ( [#644](https://github.com/NousResearch/hermes-agent/issues/644) ) - OpenAI Codex (Responses API) 支持 ChatGPT 订阅 ( [#43](https://github.com/NousResearch/hermes-agent/pull/43) ) — @grp06 - Codex OAuth 视觉支持 + 多模态内容适配器 - 根据实时 API 验证 `/model`，而非使用硬编码列表 - 支持自托管 Firecrawl ( [#460](https://github.com/NousResearch/hermes-agent/pull/460) ) — @caentzminger - 支持 Kimi Code API ( [#635](https://github.com/NousResearch/hermes-agent/pull/635) ) — @christomitov - MiniMax 模型 ID 更新 ( [#473](https://github.com/NousResearch/hermes-agent/pull/473) ) — @tars90percent - OpenRouter 提供商路由配置 (provider_preferences) - Nous 在 401 错误时刷新凭证 ( [#571](https://github.com/NousResearch/hermes-agent/pull/571), [#269](https://github.com/NousResearch/hermes-agent/pull/269) ) — @rewbs - z.ai/GLM, Kimi/Moonshot, MiniMax, Azure OpenAI 作为一级提供商 - 将统一的 `/model` 和 `/provider` 整合为单一视图 ### 代理循环与对话 - 用于提供商弹性的简单后备模型 ( [#740](https://github.com/NousResearch/hermes-agent/pull/740) ) - 父代理与子代理委托间共享迭代预算 - 通过工具结果注入实现迭代预算压力 - 可配置的子代理提供商/模型，具备完整凭证解析 - 通过压缩而非中止来处理 413 载荷过大错误 ( [#153](https://github.com/NousResearch/hermes-agent/pull/153) ) — @tekelala - 压缩后重建载荷重试 ( [#616](https://github.com/NousResearch/hermes-agent/pull/616) ) — @tripledoublev - 自动压缩病态的大型网关会话 ( [#628](https://github.com/NousResearch/hermes-agent/issues/628) ) - 工具调用修复中间件 — 自动小写转换和无效工具处理程序 - 推理努力配置和 `/reasoning` 命令 ( [#921](https://github.com/NousResearch/hermes-agent/pull/921) ) - 在上下文压缩后检测并阻止文件重读/搜索循环 ( [#705](https://github.com/NousResearch/hermes-agent/pull/705) ) — @0xbyt4 ### 会话与记忆 - 会话命名，含唯一标题、自动世系、丰富列表和按名称恢复 ( [#720](https://github.com/NousResearch/hermes-agent/pull/720) ) - 支持搜索过滤的交互式会话浏览器 ( [#733](https://github.com/NousResearch/hermes-agent/pull/733) ) - 恢复会话时显示先前消息 ( [#734](https://github.com/NousResearch/hermes-agent/pull/734) ) - Honcho AI 原生跨会话用户建模 ( [#38](https://github.com/NousResearch/hermes-agent/pull/38) ) — @erosika - 会话过期时主动异步内存刷新 - 智能上下文长度探测，带持久缓存 + 横幅显示 - 网关中用于切换到命名会话的 `/resume` 命令 - 消息平台会话重置策略 --- ## 📱 消息平台 (网关) ### Telegram - 原生文件附件：send_document + send_video - 文档文件处理，支持 PDF、文本和 Office 文件 — @tekelala - 论坛主题会话隔离 ( [#766](https://github.com/NousResearch/hermes-agent/pull/766) ) — @spanishflu-est1918 - 通过 MEDIA: 协议共享浏览器截图 ( [#657](https://github.com/NousResearch/hermes-agent/pull/657) ) - 支持“附近查找”技能的位置信息 - TTS 语音消息累积修复 ( [#176](https://github.com/NousResearch/hermes-agent/pull/176) ) — @Bartok9 - 改进的错误处理和日志记录 ( [#763](https://github.com/NousResearch/hermes-agent/pull/763) ) — @aydnOktay - 斜体正则换行符修复 + 43 项格式测试 ( [#204](https://github.com/NousResearch/hermes-agent/pull/204) ) — @0xbyt4 ### Discord - 频道主题纳入会话上下文 ( [#248](https://github.com/NousResearch/hermes-agent/pull/248) ) — @Bartok9 - DISCORD_ALLOW_BOTS 配置，用于过滤机器人消息 ( [#758](https://github.com/NousResearch/hermes-agent/pull/758) ) - 支持文档和视频 ( [#784](https://github.com/NousResearch/hermes-agent/pull/784) ) - 改进的错误处理和日志记录 ( [#761](https://github.com/NousResearch/hermes-agent/pull/761) ) — @aydnOktay ### Slack - App_mention 404 修复 + 文档/视频支持 ( [#784](https://github.com/NousResearch/hermes-agent/pull/784) ) - 结构化日志替换 print 语句 — @aydnOktay ### WhatsApp - 原生媒体发送 — 图片、视频、文档 ( [#292](https://github.com/NousResearch/hermes-agent/pull/292) ) — @satelerd - 多用户会话隔离 ( [#75](https://github.com/NousResearch/hermes-agent/pull/75) ) — @satelerd - 跨平台端口清理，替换仅 Linux 的 fuser ( [#433](https://github.com/NousResearch/hermes-agent/pull/433) ) — @Farukest - DM 中断键不匹配修复 ( [#350](https://github.com/NousResearch/hermes-agent/pull/350) ) — @Farukest ### Signal - 通过 signal-cli-rest-api 实现完整 Signal 消息网关 ( [#405](https://github.com/NousResearch/hermes-agent/issues/405) ) - 消息事件中的媒体 URL 支持 ( [#871](https://github.com/NousResearch/hermes-agent/pull/871) ) ### Email (IMAP/SMTP) - 新增邮件网关平台 — @0xbyt4 ### Home Assistant - REST 工具 + WebSocket 网关集成 ( [#184](https://github.com/NousResearch/hermes-agent/pull/184) ) — @0xbyt4 - 服务发现和增强的设置 - 工具集映射修复 ( [#538](https://github.com/NousResearch/hermes-agent/pull/538) ) — @Himess ### 网关核心 - 向用户暴露子代理工具调用和思考过程 ( [#186](https://github.com/NousResearch/hermes-agent/pull/186) ) — @cutepawss - 可配置的后台进程监视器通知 ( [#840](https://github.com/NousResearch/hermes-agent/pull/840) ) - `edit_message()` 用于 Telegram/Discord/Slack，带回退机制 - `/compress`, `/usage`, `/update` 斜杠命令 - 消除网关会话中 3 倍 SQLite 消息重复 ( [#873](https://github.com/NousResearch/hermes-agent/pull/873) ) - 跨网关回合稳定系统提示词以提升缓存命中率 ( [#754](https://github.com/NousResearch/hermes-agent/pull/754) ) - 网关退出时关闭 MCP 服务器 ( [#796](https://github.com/NousResearch/hermes-agent/pull/796) ) — @0xbyt4 - 传递 session_db 给 AIAgent，修复 session_search 错误 ( [#108](https://github.com/NousResearch/hermes-agent/pull/108) ) — @Bartok9 - 在 /retry、/undo 中持久化记录变更；修复 /reset 属性 ( [#217](https://github.com/NousResearch/hermes-agent/pull/217) ) — @Farukest - UTF-8 编码修复，防止 Windows 崩溃 ( [#369](https://github.com/NousResearch/hermes-agent/pull/369) ) — @ch3ronsa --- ## 🖥️ CLI 与用户体验 ### 交互式 CLI - 数据驱动的皮肤/主题引擎 — 7 款内置皮肤 (default, ares, mono, slate, poseidon, sisyphus, charizard) + 自定义 YAML 皮肤 - `/personality` 命令，支持自定义人格和禁用 ( [#773](https://github.com/NousResearch/hermes-agent/pull/773) ) — @teyrebaz33 - 用户定义快速命令，绕过代理循环 ( [#746](https://github.com/NousResearch/hermes-agent/pull/746) ) — @teyrebaz33 - `/reasoning` 命令，用于努力程度和显示切换 ( [#921](https://github.com/NousResearch/hermes-agent/pull/921) ) - `/verbose` 斜杠命令，运行时切换调试 ( [#94](https://github.com/NousResearch/hermes-agent/pull/94) ) — @cesareth - `/insights` 命令 — 使用分析、成本估算和活动模式 ( [#552](https://github.com/NousResearch/hermes-agent/pull/552) ) - `/background` 命令，用于管理后台进程 - `/help` 格式化，带命令分类 - 完成时响铃 — 代理完成时终端响铃 ( [#738](https://github.com/NousResearch/hermes-agent/pull/738) ) - 上/下箭头历史导航 - 剪贴板图片粘贴 (Alt+V / Ctrl+V) - 慢速斜杠命令加载指示器 ( [#882](https://github.com/NousResearch/hermes-agent/pull/882) ) - 在 patch_stdout 下修复旋转器闪烁 ( [#91](https://github.com/NousResearch/hermes-agent/pull/91) ) — @0xbyt4 - `--quiet/-Q` 标志，用于编程式单次查询模式 - `--fuck-it-ship-it` 标志，绕过所有确认提示 ( [#724](https://github.com/NousResearch/hermes-agent/pull/724) ) — @dmahan93 - 工具摘要标志 ( [#767](https://github.com/NousResearch/hermes-agent/pull/767) ) — @luisv-1 - 修复 SSH 上的终端闪烁 ( [#284](https://github.com/NousResearch/hermes-agent/pull/284) ) — @ygd58 - 多行粘贴检测修复 ( [#84](https://github.com/NousResearch/hermes-agent/pull/84) ) — @0xbyt4 ### 设置与配置 - 模块化设置向导，带分区子命令和工具优先 UX - 容器资源配置提示 - 所需二进制文件的后端验证 - 配置迁移系统 (当前 v7) - API 密钥正确路由至 .env 而非 config.yaml ( [#469](https://github.com/NousResearch/hermes-agent/pull/469) ) — @ygd58 - .env 原子写入，防止崩溃时 API 密钥丢失 ( [#954](https://github.com/NousResearch/hermes-agent/pull/954) ) - `hermes tools` — 使用 curses UI 按平台启用/禁用工具 - `hermes doctor` 用于所有已配置提供商的健康检查 - `hermes update` 带网关服务自动重启 - CLI 横幅中显示更新可用通知 - 多个命名自定义提供商 - Shell 配置检测改进，用于 PATH 设置 ( [#317](https://github.com/NousResearch/hermes-agent/pull/317) ) — @mehmetkr-31 - 一致的 HERMES_HOME 和 .env 路径解析 ( [#51](https://github.com/NousResearch/hermes-agent/pull/51), [#48](https://github.com/NousResearch/hermes-agent/pull/48) ) — @deankerr - Docker 后端修复 (macOS) + 子代理认证用于 Nous Portal ( [#46](https://github.com/NousResearch/hermes-agent/pull/46) ) — @rsavitt --- ## 🔧 工具系统 ### MCP (模型上下文协议) - 原生 MCP 客户端，支持 stdio + HTTP 传输 ( [#291](https://github.com/NousResearch/hermes-agent/pull/291) — @0xbyt4, [#301](https://github.com/NousResearch/hermes-agent/pull/301) ) - 采样支持 — 服务器发起的 LLM 请求 ( [#753](https://github.com/NousResearch/hermes-agent/pull/753) ) - 资源和提示词发现 - 自动重连和安全强化 - 横幅集成，`/reload-mcp` 命令 - `hermes tools` UI 集成 ### 浏览器 - 本地浏览器后端 — 零成本无头 Chromium (无需 Browserbase) - 控制台/错误工具、带注释截图、自动录制、自用 QA 技能 ( [#745](https://github.com/NousResearch/hermes-agent/pull/745) ) - 通过所有消息平台上的 MEDIA: 共享截图 ( [#657](https://github.com/NousResearch/hermes-agent/pull/657) ) ### 终端与执行 - `execute_code` 沙箱，含 json_parse、shell_quote、重试辅助函数 - Docker：自定义卷挂载 ( [#158](https://github.com/NousResearch/hermes-agent/pull/158) ) — @Indelwin - Daytona 云沙箱后端 ( [#451](https://github.com/NousResearch/hermes-agent/pull/451) ) — @rovle - SSH 后端修复 ( [#59](https://github.com/NousResearch/hermes-agent/pull/59) ) — @deankerr - Shell 噪音过滤和登录 shell 执行，保证环境一致性 - 针对 execute_code stdout 溢出的头部+尾部截断 - 可配置的后台进程通知模式 ### 文件操作 - 文件系统检查点和 `/rollback` 命令 ( [#824](https://github.com/NousResearch/hermes-agent/pull/824) ) - 结构化工具结果提示（后续操作指导）用于 patch 和 search_files ( [#722](https://github.com/NousResearch/hermes-agent/issues/722) ) - Docker 卷传递给沙箱容器配置 ( [#687](https://github.com/NousResearch/hermes-agent/pull/687) ) — @manuelschipper --- ## 🧩 技能生态系统 ### 技能系统 - 按平台启用/禁用技能 ( [#743](https://github.com/NousResearch/hermes-agent/pull/743) ) — @teyrebaz33 - 基于工具可用性的条件技能激活 ( [#785](https://github.com/NousResearch/hermes-agent/pull/785) ) — @teyrebaz33 - 技能先决条件 — 隐藏依赖项未满足的技能 ( [#659](https://github.com/NousResearch/hermes-agent/pull/659) ) — @kshitijk4poor - 可选技能 — 已 shipped 但默认未激活 - `hermes skills browse` — 分页中心浏览 - 技能子类别组织 - 平台条件技能加载 - 原子技能文件写入 ( [#551](https://github.com/NousResearch/hermes-agent/pull/551) ) — @aydnOktay - 防止技能同步数据丢失 ( [#563](https://github.com/NousResearch/hermes-agent/pull/563) ) — @0xbyt4 - 动态技能斜杠命令，用于 CLI 和网关 ### 新技能（精选） - **ASCII 艺术** — pyfiglet (571 字体)、cowsay、图像转 ASCII ( [#209](https://github.com/NousResearch/hermes-agent/pull/209) ) — @0xbyt4 - **ASCII 视频** — 完整制作流程 ( [#854](https://github.com/NousResearch/hermes-agent/pull/854) ) — @SHL0MS - **DuckDuckGo 搜索** — Firecrawl 回退 ( [#267](https://github.com/NousResearch/hermes-agent/pull/267) ) — @gamedevCloudy；DDGS API 扩展 ( [#598](https://github.com/NousResearch/hermes-agent/pull/598) ) — @areu01or00 - **Solana 区块链** — 钱包余额、美元定价、代币名称 ( [#212](https://github.com/NousResearch/hermes-agent/pull/212) ) — @gizdusum - **AgentMail** — 代理拥有的邮箱 ( [#330](https://github.com/NousResearch/hermes-agent/pull/330) ) — @teyrebaz33 - **Polymarket** — 预测市场数据（只读）( [#629](https://github.com/NousResearch/hermes-agent/pull/629) ) - **OpenClaw 迁移** — 官方迁移工具 ( [#570](https://github.com/NousResearch/hermes-agent/pull/570) ) — @unmodeled-tyler - **域名情报** — 被动侦察：子域名、SSL、WHOIS、DNS ( [#136](https://github.com/NousResearch/hermes-agent/pull/136) ) — @FurkanL0 - **超能力** — 软件开发技能 ( [#137](https://github.com/NousResearch/hermes-agent/pull/137) ) — @kaos35 - **Hermes-Atropos** — RL 环境开发技能 ( [#815](https://github.com/NousResearch/hermes-agent/pull/815) ) - 以及：arXiv 搜索、OCR/文档、Excalidraw 图表、YouTube 字幕、GIF 搜索、Pokémon 玩家、Minecraft modpack 服务器、OpenHue (Philips Hue)、Google Workspace、Notion、PowerPoint、Obsidian、find-nearby 和 40+ MLOps 技能 --- ## 🔒 安全与可靠性 ### 安全强化 - skill_view 中的路径遍历修复 — 防止读取任意文件 ( [#220](https://github.com/NousResearch/hermes-agent/issues/220) ) — @Farukest - sudo 密码管道中的 shell 注入防护 ( [#65](https://github.com/NousResearch/hermes-agent/pull/65) ) — @leonsgithub - 危险命令检测：多行绕过修复 ( [#233](https://github.com/NousResearch/hermes-agent/pull/233) ) — @Farukest；tee/进程替换模式 ( [#280](https://github.com/NousResearch/hermes-agent/pull/280) ) — @dogiladeveloper - skills_guard 中的符号链接边界检查修复 ( [#386](https://github.com/NousResearch/hermes-agent/pull/386) ) — @Farukest - macOS 上写入拒绝列表中的符号链接绕过修复 ( [#61](https://github.com/NousResearch/hermes-agent/pull/61) ) — @0xbyt4 - 多词提示词注入绕过防护 ( [#192](https://github.com/NousResearch/hermes-agent/pull/192) ) — @0xbyt4 - Cron 提示词注入扫描器绕过修复 ( [#63](https://github.com/NousResearch/hermes-agent/pull/63) ) — @0xbyt4 - 对敏感文件强制执行 0600/0700 文件权限 ( [#757](https://github.com/NousResearch/hermes-agent/pull/757) ) - .env 文件权限限制为仅所有者 ( [#529](https://github.com/NousResearch/hermes-agent/pull/529) ) — @Himess - `--force` 标志正确阻止覆盖危险判定 ( [#388](https://github.com/NousResearch/hermes-agent/pull/388) ) — @Farukest - FTS5 查询清理 + DB 连接泄漏修复 ( [#565](https://github.com/NousResearch/hermes-agent/pull/565) ) — @0xbyt4 - 扩展密钥脱敏模式 + 配置开关以禁用 - 内存中永久允许列表，防止数据泄漏 ( [#600](https://github.com/NousResearch/hermes-agent/pull/600) ) — @alireza78a ### 原子写入（防数据丢失） - sessions.json ( [#611](https://github.com/NousResearch/hermes-agent/pull/611) ) — @alireza78a - Cron 任务 ( [#146](https://github.com/NousResearch/hermes-agent/pull/146) ) — @alireza78a - .env 配置 ( [#954](https://github.com/NousResearch/hermes-agent/pull/954) ) - 进程检查点 ( [#298](https://github.com/NousResearch/hermes-agent/pull/298) ) — @aydnOktay - 批量运行器 ( [#297](https://github.com/NousResearch/hermes-agent/pull/297) ) — @aydnOktay - 技能文件 ( [#551](https://github.com/NousResearch/hermes-agent/pull/551) ) — @aydnOktay ### 可靠性 - 保护所有 print() 免受 OSError 影响，适用于 systemd/无头环境 ( [#963](https://github.com/NousResearch/hermes-agent/pull/963) ) - 在 run_conversation 开始时重置所有重试计数器 ( [#607](https://github.com/NousResearch/hermes-agent/pull/607) ) — @0xbyt4 - 批准回调超时时返回 deny 而非 None ( [#603](https://github.com/NousResearch/hermes-agent/pull/603) ) — @0xbyt4 - 修复整个代码库中 None 消息内容导致的崩溃 ( [#277](https://github.com/NousResearch/hermes-agent/pull/277) ) - 修复本地 LLM 后端的上下文溢出崩溃 ( [#403](https://github.com/NousResearch/hermes-agent/pull/403) ) — @ch3ronsa - 防止 `_flush_sentinel` 泄漏到外部 API ( [#227](https://github.com/NousResearch/hermes-agent/pull/227) ) — @Farukest - 防止调用者中的 conversation_history 变异 ( [#229](https://github.com/NousResearch/hermes-agent/pull/229) ) — @Farukest - 修复 systemd 重启循环 ( [#614](https://github.com/NousResearch/hermes-agent/pull/614) ) — @voidborne-d - 关闭文件句柄和套接字，防止 fd 泄漏 ( [#568](https://github.com/NousResearch/hermes-agent/pull/568) — @alireza78a, [#296](https://github.com/NousResearch/hermes-agent/pull/296) — @alireza78a, [#709](https://github.com/NousResearch/hermes-agent/pull/709) — @memosr ) - 防止剪贴板 PNG 转换中的数据丢失 ( [#602](https://github.com/NousResearch/hermes-agent/pull/602) ) — @0xbyt4 - 消除终端输出中的 shell 噪音 ( [#293](https://github.com/NousResearch/hermes-agent/pull/293) ) — @0xbyt4 - 提示词、cron 和 execute_code 的时区感知 now() ( [#309](https://github.com/NousResearch/hermes-agent/pull/309) ) — @areu01or00 ### Windows 兼容性 - 保护仅 POSIX 的进程函数 ( [#219](https://github.com/NousResearch/hermes-agent/pull/219) ) — @Farukest - 通过 Git Bash + ZIP 基础更新回退实现 Windows 原生支持 - 用于 PTY 支持的 pywinpty ( [#457](https://github.com/NousResearch/hermes-agent/pull/457) ) — @shitcoinsherpa - 所有配置/数据文件 I/O 显式使用 UTF-8 编码 ( [#458](https://github.com/NousResearch/hermes-agent/pull/458) ) — @shitcoinsherpa - Windows 兼容路径处理 ( [#354](https://github.com/NousResearch/hermes-agent/pull/354), [#390](https://github.com/NousResearch/hermes-agent/pull/390) ) — @Farukest - 针对盘符路径的正则表达式搜索输出解析 ( [#533](https://github.com/NousResearch/hermes-agent/pull/533) ) — @Himess - Windows 的认证存储文件锁 ( [#455](https://github.com/NousResearch/hermes-agent/pull/455) ) — @shitcoinsherpa --- ## 🐛 值得注意的错误修复 - 修复 DeepSeek V3 工具调用解析器静默丢弃多行 JSON 参数 ( [#444](https://github.com/NousResearch/hermes-agent/pull/444) ) — @PercyDikec - 修复网关记录因偏移不匹配每回合丢失 1 条消息 ( [#395](https://github.com/NousResearch/hermes-agent/pull/395) ) — @PercyDikec - 修复 /retry 命令静默丢弃代理最终响应 ( [#441](https://github.com/NousResearch/hermes-agent/pull/441) ) — @PercyDikec - 修复最大迭代重试在思考块剥离后返回空字符串 ( [#438](https://github.com/NousResearch/hermes-agent/pull/438) ) — @PercyDikec - 修复最大迭代重试使用硬编码 max_tokens ( [#436](https://github.com/NousResearch/hermes-agent/pull/436) ) — @Farukest - 修复 Codex 状态字典键不匹配 ( [#448](https://github.com/NousResearch/hermes-agent/pull/448) ) 和可见性过滤器 ( [#446](https://github.com/NousResearch/hermes-agent/pull/446) ) — @PercyDikec - 从最终用户可见响应中剥离 `<think>` 块 ( [#174](https://github.com/NousResearch/hermes-agent/pull/174) ) — @Bartok9 - 修复 `<think>` 块正则表达式在模型字面讨论标签时剥离可见内容 ( [#786](https://github.com/NousResearch/hermes-agent/issues/786) ) - 修复 Mistral 422 错误，源于助手消息中残留的 finish_reason ( [#253](https://github.com/NousResearch/hermes-agent/pull/253) ) — @Sertug17 - 修复所有代码路径中的 OPENROUTER_API_KEY 解析顺序 ( [#295](https://github.com/NousResearch/hermes-agent/pull/295) ) — @0xbyt4 - 修复 OPENAI_BASE_URL API 密钥优先级 ( [#420](https://github.com/NousResearch/hermes-agent/pull/420) ) — @manuelschipper - 修复 Anthropic “提示词过长” 400 错误未检测为上下文长度错误 ( [#813](https://github.com/NousResearch/hermes-agent/issues/813) ) - 修复 SQLite 会话记录累积重复消息 — 3-4 倍 token 膨胀 ( [#860](https://github.com/NousResearch/hermes-agent/issues/860) ) - 修复设置向导首次安装时跳过 API 密钥提示 ( [#748](https://github.com/NousResearch/hermes-agent/pull/748) ) - 修复设置向导为 Nous Portal 显示 OpenRouter 模型列表 ( [#575](https://github.com/NousResearch/hermes-agent/pull/575) ) — @PercyDikec - 修复通过 hermes model 切换时提供商选择不持久 ( [#881](https://github.com/NousResearch/hermes-agent/pull/881) ) - 修复 Docker 后端在 macOS 上 docker 不在 PATH 时失败 ( [#889](https://github.com/NousResearch/hermes-agent/pull/889) ) - 修复 ClawHub 技能中心适配器以适应 API 端点变更 ( [#286](https://github.com/NousResearch/hermes-agent/pull/286) ) — @BP602 - 修复 Honcho 在 API 密钥存在时自动启用 ( [#243](https://github.com/NousResearch/hermes-agent/pull/243) ) — @Bartok9 - 修复 Python 3.11+ 上重复 'skills' 子解析器崩溃 ( [#898](https://github.com/NousResearch/hermes-agent/issues/898) ) - 修复内容包含章节符号时的内存工具条目解析 ( [#162](https://github.com/NousResearch/hermes-agent/pull/162) ) — @aydnOktay - 修复交互式提示失败时 piped 安装静默中止 ( [#72](https://github.com/NousResearch/hermes-agent/pull/72) ) — @cutepawss - 修复递归删除检测中的误报 ( [#68](https://github.com/NousResearch/hermes-agent/pull/68) ) — @cutepawss - 修复整个代码库中的 Ruff lint 警告 ( [#608](https://github.com/NousResearch/hermes-agent/pull/608) ) — @JackTheGit - 修复 Anthropic 原生基础 URL 快速失败 ( [#173](https://github.com/NousResearch/hermes-agent/pull/173) ) — @adavyas - 修复 install.sh 在移动 Node.js 目录前创建 ~/.hermes ( [#53](https://github.com/NousResearch/hermes-agent/pull/53) ) — @JoshuaMart - 修复 Ctrl+C 时 atexit 清理过程中的 SystemExit 回溯 ( [#55](https://github.com/NousResearch/hermes-agent/pull/55) ) — @bierlingm - 恢复缺失的 MIT 许可证文件 ( [#620](https://github.com/NousResearch/hermes-agent/pull/620) ) — @stablegenius49 --- ## 🧪 测试 - **3,289 个测试**，涵盖代理、网关、工具、cron 和 CLI - 使用 pytest-xdist 并行化测试套件 ( [#802](https://github.com/NousResearch/hermes-agent/pull/802) ) — @OutThisLife - 单元测试批次 1：8 个核心模块 ( [#60](https://github.com/NousResearch/hermes-agent/pull/60) ) — @0xbyt4 - 单元测试批次 2：另外 8 个模块 ( [#62](https://github.com/NousResearch/hermes-agent/pull/62) ) — @0xbyt4 - 单元测试批次 3：8 个未测试模块 ( [#191](https://github.com/NousResearch/hermes-agent/pull/191) ) — @0xbyt4 - 单元测试批次 4：5 个安全/逻辑关键模块 ( [#193](https://github.com/NousResearch/hermes-agent/pull/193) ) — @0xbyt4 - AIAgent (run_agent.py) 单元测试 ( [#67](https://github.com/NousResearch/hermes-agent/pull/67) ) — @0xbyt4 - 轨迹压缩器测试 ( [#203](https://github.com/NousResearch/hermes-agent/pull/203) ) — @0xbyt4 - 澄清工具测试 ( [#121](https://github.com/NousResearch/hermes-agent/pull/121) ) — @Bartok9 - Telegram 格式测试 — 43 项斜体/粗体/代码渲染测试 ( [#204](https://github.com/NousResearch/hermes-agent/pull/204) ) — @0xbyt4 - 视觉工具类型提示 + 42 项测试 ( [#792](https://github.com/NousResearch/hermes-agent/pull/792) ) - 压缩器工具调用边界回归测试 ( [#648](https://github.com/NousResearch/hermes-agent/pull/648) ) — @intertwine - 测试结构重组 ( [#34](https://github.com/NousResearch/hermes-agent/pull/34) ) — @0xbyt4 - 消除 shell 噪音 + 修复 36 项测试失败 ( [#293](https://github.com/NousResearch/hermes-agent/pull/293) ) — @0xbyt4 --- ## 🔬 RL 与评估环境 - WebResearchEnv — 多步骤网络研究 RL 环境 ( [#434](https://github.com/NousResearch/hermes-agent/pull/434) ) — @jackx707 - Modal 沙箱并发限制，避免死锁 ( [#621](https://github.com/NousResearch/hermes-agent/pull/621) ) — @voteblake - 捆绑的 Hermes-atropos-environments 技能 ( [#815](https://github.com/NousResearch/hermes-agent/pull/815) ) - 评估用本地 vLLM 实例支持 — @dmahan93 - YC-Bench 长视野代理基准环境 - OpenThoughts-TBLite 评估环境和脚本 --- ## 📚 文档 - 完整文档网站 (Docusaurus)，含 37+ 页面 - 针对 Telegram、Discord、Slack、WhatsApp、Signal、Email 的综合平台设置指南 - AGENTS.md — AI 编码助手开发指南 - CONTRIBUTING.md ( [#117](https://github.com/NousResearch/hermes-agent/pull/117) ) — @Bartok9 - 斜杠命令参考 ( [#142](https://github.com/NousResearch/hermes-agent/pull/142) ) — @Bartok9 - 综合 AGENTS.md 准确性审计 ( [#732](https://github.com/NousResearch/hermes-agent/pull/732) ) - 皮肤/主题系统文档 - MCP 文档和示例 - 文档准确性审计 — 35+ 处修正 - 文档拼写修复 ( [#825](https://github.com/NousResearch/hermes-agent/pull/825), [#439](https://github.com/NousResearch/hermes-agent/pull/439) ) — @JackTheGit - CLI 配置优先级和术语标准化 ( [#166](https://github.com/NousResearch/hermes-agent/pull/166), [#167](https://github.com/NousResearch/hermes-agent/pull/167), [#168](https://github.com/NousResearch/hermes-agent/pull/168) ) — @Jr-kenny - Telegram 令牌正则表达式文档 ( [#713](https://github.com/NousResearch/hermes-agent/pull/713) ) — @VolodymyrBg --- ## 👥 贡献者感谢使本版本成为可能的 63 位贡献者！在短短两周多的时间里，Hermes Agent 社区携手交付了大量工作。 ### 核心 - **@teknium1** — 43 个 PR：项目负责人、核心架构、提供商路由器、会话、技能、CLI、文档 ### 顶级社区贡献者 - **@0xbyt4** — 40 个 PR：MCP 客户端、Home Assistant、安全修复（符号链接、提示词注入、cron）、 extensive 测试覆盖率（6 批）、ascii-art 技能、shell 噪音消除、技能同步、Telegram 格式化等数十项 - **@Farukest** — 16 个 PR：安全强化（路径遍历、危险命令检测、符号链接边界）、Windows 兼容性（POSIX 保护、路径处理）、WhatsApp 修复、最大迭代重试、网关修复 - **@aydnOktay** — 11 个 PR：原子写入（进程检查点、批量运行器、技能文件）、跨 Telegram、Discord、代码执行、转录、TTS 和技能的错误处理改进 - **@Bartok9** — 9 个 PR：CONTRIBUTING.md、斜杠命令参考、Discord 频道主题、思考块剥离、TTS 修复、Honcho 修复、会话计数修复、clarify 测试 - **@PercyDikec** — 7 个 PR：DeepSeek V3 解析器修复、/retry 响应丢弃、网关记录偏移、Codex 状态/可见性、最大迭代重试、设置向导修复 - **@teyrebaz33** — 5 个 PR：技能启用/禁用系统、快速命令、人格定制、条件技能激活 - **@alireza78a** — 5 个 PR：原子写入（cron、会话）、fd 泄漏防护、安全允许列表、代码执行套接字清理 - **@shitcoinsherpa** — 3 个 PR：Windows 支持（pywinpty、UTF-8 编码、认证存储锁） - **@Himess** — 3 个 PR：Cron/HomeAssistant/Daytona 修复、Windows 盘符解析、.env 权限 - **@satelerd** — 2 个 PR：WhatsApp 原生媒体、多用户会话隔离 - **@rovle** — 1 个 PR：Daytona 云沙箱后端（4 次提交） - **@erosika** — 1 个 PR：Honcho AI 原生内存集成 - **@dmahan93** — 1 个 PR：--fuck-it-ship-it 标志 + RL 环境工作 - **@SHL0MS** — 1 个 PR：ASCII 视频技能 ### 所有贡献者 @0xbyt4, @BP602, @Bartok9, @Farukest, @FurkanL0, @Himess, @Indelwin, @JackTheGit, @JoshuaMart, @Jr-kenny, @OutThisLife, @PercyDikec, @SHL0MS, @Sertug17, @VencentSoliman, @VolodymyrBg, @adavyas, @alireza78a, @areu01or00, @aydnOktay, @batuhankocyigit, @bierlingm, @caentzminger, @cesareth, @ch3ronsa, @christomitov, @cutepawss, @deankerr, @dmahan93, @dogiladeveloper, @dragonkhoi, @erosika, @gamedevCloudy, @gizdusum, @grp06, @intertwine, @jackx707, @jdblackstar, @johnh4098, @kaos35, @kshitijk4poor, @leonsgithub, @luisv-1, @manuelschipper, @mehmetkr-31, @memosr, @PeterFile, @rewbs, @rovle, @rsavitt, @satelerd, @spanishflu-est1918, @stablegenius49, @tars90percent, @tekelala, @teknium1, @teyrebaz33, @tripledoublev, @unmodeled-tyler, @voidborne-d, @voteblake, @ygd58 --- **完整更新日志**：[v0.1.0...v2026.3.12](https://github.com/NousResearch/hermes-agent/compare/v0.1.0...v2026.3.12)

# Hermes Agent v0.2.0 (v2026.3.12) **Release Date:** March 12, 2026 > First tagged release since v0.1.0 (the initial pre-public foundation). In just over two weeks, Hermes Agent went from a small internal project to a full-featured AI agent platform — thanks to an explosion of community contributions. This release covers **216 merged pull requests** from **63 contributors**, resolving **119 issues**. --- ## ✨ Highlights - **Multi-Platform Messaging Gateway** — Telegram, Discord, Slack, WhatsApp, Signal, Email (IMAP/SMTP), and Home Assistant platforms with unified session management, media attachments, and per-platform tool configuration. - **MCP (Model Context Protocol) Client** — Native MCP support with stdio and HTTP transports, reconnection, resource/prompt discovery, and sampling (server-initiated LLM requests). ([#291](https://github.com/NousResearch/hermes-agent/pull/291) — @0xbyt4, [#301](https://github.com/NousResearch/hermes-agent/pull/301), [#753](https://github.com/NousResearch/hermes-agent/pull/753)) - **Skills Ecosystem** — 70+ bundled and optional skills across 15+ categories with a Skills Hub for community discovery, per-platform enable/disable, conditional activation based on tool availability, and prerequisite validation. ([#743](https://github.com/NousResearch/hermes-agent/pull/743) — @teyrebaz33, [#785](https://github.com/NousResearch/hermes-agent/pull/785) — @teyrebaz33) - **Centralized Provider Router** — Unified `call_llm()`/`async_call_llm()` API replaces scattered provider logic across vision, summarization, compression, and trajectory saving. All auxiliary consumers route through a single code path with automatic credential resolution. ([#1003](https://github.com/NousResearch/hermes-agent/pull/1003)) - **ACP Server** — VS Code, Zed, and JetBrains editor integration via the Agent Communication Protocol standard. ([#949](https://github.com/NousResearch/hermes-agent/pull/949)) - **CLI Skin/Theme Engine** — Data-driven visual customization: banners, spinners, colors, branding. 7 built-in skins + custom YAML skins. - **Git Worktree Isolation** — `hermes -w` launches isolated agent sessions in git worktrees for safe parallel work on the same repo. ([#654](https://github.com/NousResearch/hermes-agent/pull/654)) - **Filesystem Checkpoints & Rollback** — Automatic snapshots before destructive operations with `/rollback` to restore. ([#824](https://github.com/NousResearch/hermes-agent/pull/824)) - **3,289 Tests** — From near-zero test coverage to a comprehensive test suite covering agent, gateway, tools, cron, and CLI. --- ## 🏗️ Core Agent & Architecture ### Provider & Model Support - Centralized provider router with `resolve_provider_client()` + `call_llm()` API ([#1003](https://github.com/NousResearch/hermes-agent/pull/1003)) - Nous Portal as first-class provider in setup ([#644](https://github.com/NousResearch/hermes-agent/issues/644)) - OpenAI Codex (Responses API) with ChatGPT subscription support ([#43](https://github.com/NousResearch/hermes-agent/pull/43)) — @grp06 - Codex OAuth vision support + multimodal content adapter - Validate `/model` against live API instead of hardcoded lists - Self-hosted Firecrawl support ([#460](https://github.com/NousResearch/hermes-agent/pull/460)) — @caentzminger - Kimi Code API support ([#635](https://github.com/NousResearch/hermes-agent/pull/635)) — @christomitov - MiniMax model ID update ([#473](https://github.com/NousResearch/hermes-agent/pull/473)) — @tars90percent - OpenRouter provider routing configuration (provider_preferences) - Nous credential refresh on 401 errors ([#571](https://github.com/NousResearch/hermes-agent/pull/571), [#269](https://github.com/NousResearch/hermes-agent/pull/269)) — @rewbs - z.ai/GLM, Kimi/Moonshot, MiniMax, Azure OpenAI as first-class providers - Unified `/model` and `/provider` into single view ### Agent Loop & Conversation - Simple fallback model for provider resilience ([#740](https://github.com/NousResearch/hermes-agent/pull/740)) - Shared iteration budget across parent + subagent delegation - Iteration budget pressure via tool result injection - Configurable subagent provider/model with full credential resolution - Handle 413 payload-too-large via compression instead of aborting ([#153](https://github.com/NousResearch/hermes-agent/pull/153)) — @tekelala - Retry with rebuilt payload after compression ([#616](https://github.com/NousResearch/hermes-agent/pull/616)) — @tripledoublev - Auto-compress pathologically large gateway sessions ([#628](https://github.com/NousResearch/hermes-agent/issues/628)) - Tool call repair middleware — auto-lowercase and invalid tool handler - Reasoning effort configuration and `/reasoning` command ([#921](https://github.com/NousResearch/hermes-agent/pull/921)) - Detect and block file re-read/search loops after context compression ([#705](https://github.com/NousResearch/hermes-agent/pull/705)) — @0xbyt4 ### Session & Memory - Session naming with unique titles, auto-lineage, rich listing, and resume by name ([#720](https://github.com/NousResearch/hermes-agent/pull/720)) - Interactive session browser with search filtering ([#733](https://github.com/NousResearch/hermes-agent/pull/733)) - Display previous messages when resuming a session ([#734](https://github.com/NousResearch/hermes-agent/pull/734)) - Honcho AI-native cross-session user modeling ([#38](https://github.com/NousResearch/hermes-agent/pull/38)) — @erosika - Proactive async memory flush on session expiry - Smart context length probing with persistent caching + banner display - `/resume` command for switching to named sessions in gateway - Session reset policy for messaging platforms --- ## 📱 Messaging Platforms (Gateway) ### Telegram - Native file attachments: send_document + send_video - Document file processing for PDF, text, and Office files — @tekelala - Forum topic session isolation ([#766](https://github.com/NousResearch/hermes-agent/pull/766)) — @spanishflu-est1918 - Browser screenshot sharing via MEDIA: protocol ([#657](https://github.com/NousResearch/hermes-agent/pull/657)) - Location support for find-nearby skill - TTS voice message accumulation fix ([#176](https://github.com/NousResearch/hermes-agent/pull/176)) — @Bartok9 - Improved error handling and logging ([#763](https://github.com/NousResearch/hermes-agent/pull/763)) — @aydnOktay - Italic regex newline fix + 43 format tests ([#204](https://github.com/NousResearch/hermes-agent/pull/204)) — @0xbyt4 ### Discord - Channel topic included in session context ([#248](https://github.com/NousResearch/hermes-agent/pull/248)) — @Bartok9 - DISCORD_ALLOW_BOTS config for bot message filtering ([#758](https://github.com/NousResearch/hermes-agent/pull/758)) - Document and video support ([#784](https://github.com/NousResearch/hermes-agent/pull/784)) - Improved error handling and logging ([#761](https://github.com/NousResearch/hermes-agent/pull/761)) — @aydnOktay ### Slack - App_mention 404 fix + document/video support ([#784](https://github.com/NousResearch/hermes-agent/pull/784)) - Structured logging replacing print statements — @aydnOktay ### WhatsApp - Native media sending — images, videos, documents ([#292](https://github.com/NousResearch/hermes-agent/pull/292)) — @satelerd - Multi-user session isolation ([#75](https://github.com/NousResearch/hermes-agent/pull/75)) — @satelerd - Cross-platform port cleanup replacing Linux-only fuser ([#433](https://github.com/NousResearch/hermes-agent/pull/433)) — @Farukest - DM interrupt key mismatch fix ([#350](https://github.com/NousResearch/hermes-agent/pull/350)) — @Farukest ### Signal - Full Signal messenger gateway via signal-cli-rest-api ([#405](https://github.com/NousResearch/hermes-agent/issues/405)) - Media URL support in message events ([#871](https://github.com/NousResearch/hermes-agent/pull/871)) ### Email (IMAP/SMTP) - New email gateway platform — @0xbyt4 ### Home Assistant - REST tools + WebSocket gateway integration ([#184](https://github.com/NousResearch/hermes-agent/pull/184)) — @0xbyt4 - Service discovery and enhanced setup - Toolset mapping fix ([#538](https://github.com/NousResearch/hermes-agent/pull/538)) — @Himess ### Gateway Core - Expose subagent tool calls and thinking to users ([#186](https://github.com/NousResearch/hermes-agent/pull/186)) — @cutepawss - Configurable background process watcher notifications ([#840](https://github.com/NousResearch/hermes-agent/pull/840)) - `edit_message()` for Telegram/Discord/Slack with fallback - `/compress`, `/usage`, `/update` slash commands - Eliminated 3x SQLite message duplication in gateway sessions ([#873](https://github.com/NousResearch/hermes-agent/pull/873)) - Stabilize system prompt across gateway turns for cache hits ([#754](https://github.com/NousResearch/hermes-agent/pull/754)) - MCP server shutdown on gateway exit ([#796](https://github.com/NousResearch/hermes-agent/pull/796)) — @0xbyt4 - Pass session_db to AIAgent, fixing session_search error ([#108](https://github.com/NousResearch/hermes-agent/pull/108)) — @Bartok9 - Persist transcript changes in /retry, /undo; fix /reset attribute ([#217](https://github.com/NousResearch/hermes-agent/pull/217)) — @Farukest - UTF-8 encoding fix preventing Windows crashes ([#369](https://github.com/NousResearch/hermes-agent/pull/369)) — @ch3ronsa --- ## 🖥️ CLI & User Experience ### Interactive CLI - Data-driven skin/theme engine — 7 built-in skins (default, ares, mono, slate, poseidon, sisyphus, charizard) + custom YAML skins - `/personality` command with custom personality + disable support ([#773](https://github.com/NousResearch/hermes-agent/pull/773)) — @teyrebaz33 - User-defined quick commands that bypass the agent loop ([#746](https://github.com/NousResearch/hermes-agent/pull/746)) — @teyrebaz33 - `/reasoning` command for effort level and display toggle ([#921](https://github.com/NousResearch/hermes-agent/pull/921)) - `/verbose` slash command to toggle debug at runtime ([#94](https://github.com/NousResearch/hermes-agent/pull/94)) — @cesareth - `/insights` command — usage analytics, cost estimation & activity patterns ([#552](https://github.com/NousResearch/hermes-agent/pull/552)) - `/background` command for managing background processes - `/help` formatting with command categories - Bell-on-complete — terminal bell when agent finishes ([#738](https://github.com/NousResearch/hermes-agent/pull/738)) - Up/down arrow history navigation - Clipboard image paste (Alt+V / Ctrl+V) - Loading indicators for slow slash commands ([#882](https://github.com/NousResearch/hermes-agent/pull/882)) - Spinner flickering fix under patch_stdout ([#91](https://github.com/NousResearch/hermes-agent/pull/91)) — @0xbyt4 - `--quiet/-Q` flag for programmatic single-query mode - `--fuck-it-ship-it` flag to bypass all approval prompts ([#724](https://github.com/NousResearch/hermes-agent/pull/724)) — @dmahan93 - Tools summary flag ([#767](https://github.com/NousResearch/hermes-agent/pull/767)) — @luisv-1 - Terminal blinking fix on SSH ([#284](https://github.com/NousResearch/hermes-agent/pull/284)) — @ygd58 - Multi-line paste detection fix ([#84](https://github.com/NousResearch/hermes-agent/pull/84)) — @0xbyt4 ### Setup & Configuration - Modular setup wizard with section subcommands and tool-first UX - Container resource configuration prompts - Backend validation for required binaries - Config migration system (currently v7) - API keys properly routed to .env instead of config.yaml ([#469](https://github.com/NousResearch/hermes-agent/pull/469)) — @ygd58 - Atomic write for .env to prevent API key loss on crash ([#954](https://github.com/NousResearch/hermes-agent/pull/954)) - `hermes tools` — per-platform tool enable/disable with curses UI - `hermes doctor` for health checks across all configured providers - `hermes update` with auto-restart for gateway service - Show update-available notice in CLI banner - Multiple named custom providers - Shell config detection improvement for PATH setup ([#317](https://github.com/NousResearch/hermes-agent/pull/317)) — @mehmetkr-31 - Consistent HERMES_HOME and .env path resolution ([#51](https://github.com/NousResearch/hermes-agent/pull/51), [#48](https://github.com/NousResearch/hermes-agent/pull/48)) — @deankerr - Docker backend fix on macOS + subagent auth for Nous Portal ([#46](https://github.com/NousResearch/hermes-agent/pull/46)) — @rsavitt --- ## 🔧 Tool System ### MCP (Model Context Protocol) - Native MCP client with stdio + HTTP transports ([#291](https://github.com/NousResearch/hermes-agent/pull/291) — @0xbyt4, [#301](https://github.com/NousResearch/hermes-agent/pull/301)) - Sampling support — server-initiated LLM requests ([#753](https://github.com/NousResearch/hermes-agent/pull/753)) - Resource and prompt discovery - Automatic reconnection and security hardening - Banner integration, `/reload-mcp` command - `hermes tools` UI integration ### Browser - Local browser backend — zero-cost headless Chromium (no Browserbase needed) - Console/errors tool, annotated screenshots, auto-recording, dogfood QA skill ([#745](https://github.com/NousResearch/hermes-agent/pull/745)) - Screenshot sharing via MEDIA: on all messaging platforms ([#657](https://github.com/NousResearch/hermes-agent/pull/657)) ### Terminal & Execution - `execute_code` sandbox with json_parse, shell_quote, retry helpers - Docker: custom volume mounts ([#158](https://github.com/NousResearch/hermes-agent/pull/158)) — @Indelwin - Daytona cloud sandbox backend ([#451](https://github.com/NousResearch/hermes-agent/pull/451)) — @rovle - SSH backend fix ([#59](https://github.com/NousResearch/hermes-agent/pull/59)) — @deankerr - Shell noise filtering and login shell execution for environment consistency - Head+tail truncation for execute_code stdout overflow - Configurable background process notification modes ### File Operations - Filesystem checkpoints and `/rollback` command ([#824](https://github.com/NousResearch/hermes-agent/pull/824)) - Structured tool result hints (next-action guidance) for patch and search_files ([#722](https://github.com/NousResearch/hermes-agent/issues/722)) - Docker volumes passed to sandbox container config ([#687](https://github.com/NousResearch/hermes-agent/pull/687)) — @manuelschipper --- ## 🧩 Skills Ecosystem ### Skills System - Per-platform skill enable/disable ([#743](https://github.com/NousResearch/hermes-agent/pull/743)) — @teyrebaz33 - Conditional skill activation based on tool availability ([#785](https://github.com/NousResearch/hermes-agent/pull/785)) — @teyrebaz33 - Skill prerequisites — hide skills with unmet dependencies ([#659](https://github.com/NousResearch/hermes-agent/pull/659)) — @kshitijk4poor - Optional skills — shipped but not activated by default - `hermes skills browse` — paginated hub browsing - Skills sub-category organization - Platform-conditional skill loading - Atomic skill file writes ([#551](https://github.com/NousResearch/hermes-agent/pull/551)) — @aydnOktay - Skills sync data loss prevention ([#563](https://github.com/NousResearch/hermes-agent/pull/563)) — @0xbyt4 - Dynamic skill slash commands for CLI and gateway ### New Skills (selected) - **ASCII Art** — pyfiglet (571 fonts), cowsay, image-to-ascii ([#209](https://github.com/NousResearch/hermes-agent/pull/209)) — @0xbyt4 - **ASCII Video** — Full production pipeline ([#854](https://github.com/NousResearch/hermes-agent/pull/854)) — @SHL0MS - **DuckDuckGo Search** — Firecrawl fallback ([#267](https://github.com/NousResearch/hermes-agent/pull/267)) — @gamedevCloudy; DDGS API expansion ([#598](https://github.com/NousResearch/hermes-agent/pull/598)) — @areu01or00 - **Solana Blockchain** — Wallet balances, USD pricing, token names ([#212](https://github.com/NousResearch/hermes-agent/pull/212)) — @gizdusum - **AgentMail** — Agent-owned email inboxes ([#330](https://github.com/NousResearch/hermes-agent/pull/330)) — @teyrebaz33 - **Polymarket** — Prediction market data (read-only) ([#629](https://github.com/NousResearch/hermes-agent/pull/629)) - **OpenClaw Migration** — Official migration tool ([#570](https://github.com/NousResearch/hermes-agent/pull/570)) — @unmodeled-tyler - **Domain Intelligence** — Passive recon: subdomains, SSL, WHOIS, DNS ([#136](https://github.com/NousResearch/hermes-agent/pull/136)) — @FurkanL0 - **Superpowers** — Software development skills ([#137](https://github.com/NousResearch/hermes-agent/pull/137)) — @kaos35 - **Hermes-Atropos** — RL environment development skill ([#815](https://github.com/NousResearch/hermes-agent/pull/815)) - Plus: arXiv search, OCR/documents, Excalidraw diagrams, YouTube transcripts, GIF search, Pokémon player, Minecraft modpack server, OpenHue (Philips Hue), Google Workspace, Notion, PowerPoint, Obsidian, find-nearby, and 40+ MLOps skills --- ## 🔒 Security & Reliability ### Security Hardening - Path traversal fix in skill_view — prevented reading arbitrary files ([#220](https://github.com/NousResearch/hermes-agent/issues/220)) — @Farukest - Shell injection prevention in sudo password piping ([#65](https://github.com/NousResearch/hermes-agent/pull/65)) — @leonsgithub - Dangerous command detection: multiline bypass fix ([#233](https://github.com/NousResearch/hermes-agent/pull/233)) — @Farukest; tee/process substitution patterns ([#280](https://github.com/NousResearch/hermes-agent/pull/280)) — @dogiladeveloper - Symlink boundary check fix in skills_guard ([#386](https://github.com/NousResearch/hermes-agent/pull/386)) — @Farukest - Symlink bypass fix in write deny list on macOS ([#61](https://github.com/NousResearch/hermes-agent/pull/61)) — @0xbyt4 - Multi-word prompt injection bypass prevention ([#192](https://github.com/NousResearch/hermes-agent/pull/192)) — @0xbyt4 - Cron prompt injection scanner bypass fix ([#63](https://github.com/NousResearch/hermes-agent/pull/63)) — @0xbyt4 - Enforce 0600/0700 file permissions on sensitive files ([#757](https://github.com/NousResearch/hermes-agent/pull/757)) - .env file permissions restricted to owner-only ([#529](https://github.com/NousResearch/hermes-agent/pull/529)) — @Himess - `--force` flag properly blocked from overriding dangerous verdicts ([#388](https://github.com/NousResearch/hermes-agent/pull/388)) — @Farukest - FTS5 query sanitization + DB connection leak fix ([#565](https://github.com/NousResearch/hermes-agent/pull/565)) — @0xbyt4 - Expand secret redaction patterns + config toggle to disable - In-memory permanent allowlist to prevent data leak ([#600](https://github.com/NousResearch/hermes-agent/pull/600)) — @alireza78a ### Atomic Writes (data loss prevention) - sessions.json ([#611](https://github.com/NousResearch/hermes-agent/pull/611)) — @alireza78a - Cron jobs ([#146](https://github.com/NousResearch/hermes-agent/pull/146)) — @alireza78a - .env config ([#954](https://github.com/NousResearch/hermes-agent/pull/954)) - Process checkpoints ([#298](https://github.com/NousResearch/hermes-agent/pull/298)) — @aydnOktay - Batch runner ([#297](https://github.com/NousResearch/hermes-agent/pull/297)) — @aydnOktay - Skill files ([#551](https://github.com/NousResearch/hermes-agent/pull/551)) — @aydnOktay ### Reliability - Guard all print() against OSError for systemd/headless environments ([#963](https://github.com/NousResearch/hermes-agent/pull/963)) - Reset all retry counters at start of run_conversation ([#607](https://github.com/NousResearch/hermes-agent/pull/607)) — @0xbyt4 - Return deny on approval callback timeout instead of None ([#603](https://github.com/NousResearch/hermes-agent/pull/603)) — @0xbyt4 - Fix None message content crashes across codebase ([#277](https://github.com/NousResearch/hermes-agent/pull/277)) - Fix context overrun crash with local LLM backends ([#403](https://github.com/NousResearch/hermes-agent/pull/403)) — @ch3ronsa - Prevent `_flush_sentinel` from leaking to external APIs ([#227](https://github.com/NousResearch/hermes-agent/pull/227)) — @Farukest - Prevent conversation_history mutation in callers ([#229](https://github.com/NousResearch/hermes-agent/pull/229)) — @Farukest - Fix systemd restart loop ([#614](https://github.com/NousResearch/hermes-agent/pull/614)) — @voidborne-d - Close file handles and sockets to prevent fd leaks ([#568](https://github.com/NousResearch/hermes-agent/pull/568) — @alireza78a, [#296](https://github.com/NousResearch/hermes-agent/pull/296) — @alireza78a, [#709](https://github.com/NousResearch/hermes-agent/pull/709) — @memosr) - Prevent data loss in clipboard PNG conversion ([#602](https://github.com/NousResearch/hermes-agent/pull/602)) — @0xbyt4 - Eliminate shell noise from terminal output ([#293](https://github.com/NousResearch/hermes-agent/pull/293)) — @0xbyt4 - Timezone-aware now() for prompt, cron, and execute_code ([#309](https://github.com/NousResearch/hermes-agent/pull/309)) — @areu01or00 ### Windows Compatibility - Guard POSIX-only process functions ([#219](https://github.com/NousResearch/hermes-agent/pull/219)) — @Farukest - Windows native support via Git Bash + ZIP-based update fallback - pywinpty for PTY support ([#457](https://github.com/NousResearch/hermes-agent/pull/457)) — @shitcoinsherpa - Explicit UTF-8 encoding on all config/data file I/O ([#458](https://github.com/NousResearch/hermes-agent/pull/458)) — @shitcoinsherpa - Windows-compatible path handling ([#354](https://github.com/NousResearch/hermes-agent/pull/354), [#390](https://github.com/NousResearch/hermes-agent/pull/390)) — @Farukest - Regex-based search output parsing for drive-letter paths ([#533](https://github.com/NousResearch/hermes-agent/pull/533)) — @Himess - Auth store file lock for Windows ([#455](https://github.com/NousResearch/hermes-agent/pull/455)) — @shitcoinsherpa --- ## 🐛 Notable Bug Fixes - Fix DeepSeek V3 tool call parser silently dropping multi-line JSON arguments ([#444](https://github.com/NousResearch/hermes-agent/pull/444)) — @PercyDikec - Fix gateway transcript losing 1 message per turn due to offset mismatch ([#395](https://github.com/NousResearch/hermes-agent/pull/395)) — @PercyDikec - Fix /retry command silently discarding the agent's final response ([#441](https://github.com/NousResearch/hermes-agent/pull/441)) — @PercyDikec - Fix max-iterations retry returning empty string after think-block stripping ([#438](https://github.com/NousResearch/hermes-agent/pull/438)) — @PercyDikec - Fix max-iterations retry using hardcoded max_tokens ([#436](https://github.com/NousResearch/hermes-agent/pull/436)) — @Farukest - Fix Codex status dict key mismatch ([#448](https://github.com/NousResearch/hermes-agent/pull/448)) and visibility filter ([#446](https://github.com/NousResearch/hermes-agent/pull/446)) — @PercyDikec - Strip \<think\> blocks from final user-facing responses ([#174](https://github.com/NousResearch/hermes-agent/pull/174)) — @Bartok9 - Fix \<think\> block regex stripping visible content when model discusses tags literally ([#786](https://github.com/NousResearch/hermes-agent/issues/786)) - Fix Mistral 422 errors from leftover finish_reason in assistant messages ([#253](https://github.com/NousResearch/hermes-agent/pull/253)) — @Sertug17 - Fix OPENROUTER_API_KEY resolution order across all code paths ([#295](https://github.com/NousResearch/hermes-agent/pull/295)) — @0xbyt4 - Fix OPENAI_BASE_URL API key priority ([#420](https://github.com/NousResearch/hermes-agent/pull/420)) — @manuelschipper - Fix Anthropic "prompt is too long" 400 error not detected as context length error ([#813](https://github.com/NousResearch/hermes-agent/issues/813)) - Fix SQLite session transcript accumulating duplicate messages — 3-4x token inflation ([#860](https://github.com/NousResearch/hermes-agent/issues/860)) - Fix setup wizard skipping API key prompts on first install ([#748](https://github.com/NousResearch/hermes-agent/pull/748)) - Fix setup wizard showing OpenRouter model list for Nous Portal ([#575](https://github.com/NousResearch/hermes-agent/pull/575)) — @PercyDikec - Fix provider selection not persisting when switching via hermes model ([#881](https://github.com/NousResearch/hermes-agent/pull/881)) - Fix Docker backend failing when docker not in PATH on macOS ([#889](https://github.com/NousResearch/hermes-agent/pull/889)) - Fix ClawHub Skills Hub adapter for API endpoint changes ([#286](https://github.com/NousResearch/hermes-agent/pull/286)) — @BP602 - Fix Honcho auto-enable when API key is present ([#243](https://github.com/NousResearch/hermes-agent/pull/243)) — @Bartok9 - Fix duplicate 'skills' subparser crash on Python 3.11+ ([#898](https://github.com/NousResearch/hermes-agent/issues/898)) - Fix memory tool entry parsing when content contains section sign ([#162](https://github.com/NousResearch/hermes-agent/pull/162)) — @aydnOktay - Fix piped install silently aborting when interactive prompts fail ([#72](https://github.com/NousResearch/hermes-agent/pull/72)) — @cutepawss - Fix false positives in recursive delete detection ([#68](https://github.com/NousResearch/hermes-agent/pull/68)) — @cutepawss - Fix Ruff lint warnings across codebase ([#608](https://github.com/NousResearch/hermes-agent/pull/608)) — @JackTheGit - Fix Anthropic native base URL fail-fast ([#173](https://github.com/NousResearch/hermes-agent/pull/173)) — @adavyas - Fix install.sh creating ~/.hermes before moving Node.js directory ([#53](https://github.com/NousResearch/hermes-agent/pull/53)) — @JoshuaMart - Fix SystemExit traceback during atexit cleanup on Ctrl+C ([#55](https://github.com/NousResearch/hermes-agent/pull/55)) — @bierlingm - Restore missing MIT license file ([#620](https://github.com/NousResearch/hermes-agent/pull/620)) — @stablegenius49 --- ## 🧪 Testing - **3,289 tests** across agent, gateway, tools, cron, and CLI - Parallelized test suite with pytest-xdist ([#802](https://github.com/NousResearch/hermes-agent/pull/802)) — @OutThisLife - Unit tests batch 1: 8 core modules ([#60](https://github.com/NousResearch/hermes-agent/pull/60)) — @0xbyt4 - Unit tests batch 2: 8 more modules ([#62](https://github.com/NousResearch/hermes-agent/pull/62)) — @0xbyt4 - Unit tests batch 3: 8 untested modules ([#191](https://github.com/NousResearch/hermes-agent/pull/191)) — @0xbyt4 - Unit tests batch 4: 5 security/logic-critical modules ([#193](https://github.com/NousResearch/hermes-agent/pull/193)) — @0xbyt4 - AIAgent (run_agent.py) unit tests ([#67](https://github.com/NousResearch/hermes-agent/pull/67)) — @0xbyt4 - Trajectory compressor tests ([#203](https://github.com/NousResearch/hermes-agent/pull/203)) — @0xbyt4 - Clarify tool tests ([#121](https://github.com/NousResearch/hermes-agent/pull/121)) — @Bartok9 - Telegram format tests — 43 tests for italic/bold/code rendering ([#204](https://github.com/NousResearch/hermes-agent/pull/204)) — @0xbyt4 - Vision tools type hints + 42 tests ([#792](https://github.com/NousResearch/hermes-agent/pull/792)) - Compressor tool-call boundary regression tests ([#648](https://github.com/NousResearch/hermes-agent/pull/648)) — @intertwine - Test structure reorganization ([#34](https://github.com/NousResearch/hermes-agent/pull/34)) — @0xbyt4 - Shell noise elimination + fix 36 test failures ([#293](https://github.com/NousResearch/hermes-agent/pull/293)) — @0xbyt4 --- ## 🔬 RL & Evaluation Environments - WebResearchEnv — Multi-step web research RL environment ([#434](https://github.com/NousResearch/hermes-agent/pull/434)) — @jackx707 - Modal sandbox concurrency limits to avoid deadlocks ([#621](https://github.com/NousResearch/hermes-agent/pull/621)) — @voteblake - Hermes-atropos-environments bundled skill ([#815](https://github.com/NousResearch/hermes-agent/pull/815)) - Local vLLM instance support for evaluation — @dmahan93 - YC-Bench long-horizon agent benchmark environment - OpenThoughts-TBLite evaluation environment and scripts --- ## 📚 Documentation - Full documentation website (Docusaurus) with 37+ pages - Comprehensive platform setup guides for Telegram, Discord, Slack, WhatsApp, Signal, Email - AGENTS.md — development guide for AI coding assistants - CONTRIBUTING.md ([#117](https://github.com/NousResearch/hermes-agent/pull/117)) — @Bartok9 - Slash commands reference ([#142](https://github.com/NousResearch/hermes-agent/pull/142)) — @Bartok9 - Comprehensive AGENTS.md accuracy audit ([#732](https://github.com/NousResearch/hermes-agent/pull/732)) - Skin/theme system documentation - MCP documentation and examples - Docs accuracy audit — 35+ corrections - Documentation typo fixes ([#825](https://github.com/NousResearch/hermes-agent/pull/825), [#439](https://github.com/NousResearch/hermes-agent/pull/439)) — @JackTheGit - CLI config precedence and terminology standardization ([#166](https://github.com/NousResearch/hermes-agent/pull/166), [#167](https://github.com/NousResearch/hermes-agent/pull/167), [#168](https://github.com/NousResearch/hermes-agent/pull/168)) — @Jr-kenny - Telegram token regex documentation ([#713](https://github.com/NousResearch/hermes-agent/pull/713)) — @VolodymyrBg --- ## 👥 Contributors Thank you to the 63 contributors who made this release possible! In just over two weeks, the Hermes Agent community came together to ship an extraordinary amount of work. ### Core - **@teknium1** — 43 PRs: Project lead, core architecture, provider router, sessions, skills, CLI, documentation ### Top Community Contributors - **@0xbyt4** — 40 PRs: MCP client, Home Assistant, security fixes (symlink, prompt injection, cron), extensive test coverage (6 batches), ascii-art skill, shell noise elimination, skills sync, Telegram formatting, and dozens more - **@Farukest** — 16 PRs: Security hardening (path traversal, dangerous command detection, symlink boundary), Windows compatibility (POSIX guards, path handling), WhatsApp fixes, max-iterations retry, gateway fixes - **@aydnOktay** — 11 PRs: Atomic writes (process checkpoints, batch runner, skill files), error handling improvements across Telegram, Discord, code execution, transcription, TTS, and skills - **@Bartok9** — 9 PRs: CONTRIBUTING.md, slash commands reference, Discord channel topics, think-block stripping, TTS fix, Honcho fix, session count fix, clarify tests - **@PercyDikec** — 7 PRs: DeepSeek V3 parser fix, /retry response discard, gateway transcript offset, Codex status/visibility, max-iterations retry, setup wizard fix - **@teyrebaz33** — 5 PRs: Skills enable/disable system, quick commands, personality customization, conditional skill activation - **@alireza78a** — 5 PRs: Atomic writes (cron, sessions), fd leak prevention, security allowlist, code execution socket cleanup - **@shitcoinsherpa** — 3 PRs: Windows support (pywinpty, UTF-8 encoding, auth store lock) - **@Himess** — 3 PRs: Cron/HomeAssistant/Daytona fix, Windows drive-letter parsing, .env permissions - **@satelerd** — 2 PRs: WhatsApp native media, multi-user session isolation - **@rovle** — 1 PR: Daytona cloud sandbox backend (4 commits) - **@erosika** — 1 PR: Honcho AI-native memory integration - **@dmahan93** — 1 PR: --fuck-it-ship-it flag + RL environment work - **@SHL0MS** — 1 PR: ASCII video skill ### All Contributors @0xbyt4, @BP602, @Bartok9, @Farukest, @FurkanL0, @Himess, @Indelwin, @JackTheGit, @JoshuaMart, @Jr-kenny, @OutThisLife, @PercyDikec, @SHL0MS, @Sertug17, @VencentSoliman, @VolodymyrBg, @adavyas, @alireza78a, @areu01or00, @aydnOktay, @batuhankocyigit, @bierlingm, @caentzminger, @cesareth, @ch3ronsa, @christomitov, @cutepawss, @deankerr, @dmahan93, @dogiladeveloper, @dragonkhoi, @erosika, @gamedevCloudy, @gizdusum, @grp06, @intertwine, @jackx707, @jdblackstar, @johnh4098, @kaos35, @kshitijk4poor, @leonsgithub, @luisv-1, @manuelschipper, @mehmetkr-31, @memosr, @PeterFile, @rewbs, @rovle, @rsavitt, @satelerd, @spanishflu-est1918, @stablegenius49, @tars90percent, @tekelala, @teknium1, @teyrebaz33, @tripledoublev, @unmodeled-tyler, @voidborne-d, @voteblake, @ygd58 --- **Full Changelog**: [v0.1.0...v2026.3.12](https://github.com/NousResearch/hermes-agent/compare/v0.1.0...v2026.3.12)