YantrikDB Hermes 记忆插件
为 Hermes Agent 提供可维护、可追溯的持久记忆,减少重复、过时或互相矛盾的事实。
- Star 数
- ★ 97
- 最近更新
- 16 天前
- License
- MIT
- 主语言
- Python
- FA 评分
- 72/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 兼容但需适配
- 费用
- 免费,无需付费服务
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 使用 Hermes 的开发者希望跨会话保留用户偏好,并在后续对话中检索。
- 不适合
- 需要直接安装到 Claude Code、Cursor 或其他非 Hermes 助手的团队
- 需要跨独立进程共享记忆、但不愿部署 HTTP 后端的团队
- 官网
- yantrikdb.com ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-04最新版本 v0.28.0(2026-11-03)
- 源码审查
- 72/100 · 存在缺口
这个 Agent 能做什么,适合哪些场景?
这是一个为 NousResearch Hermes Agent 提供 YantrikDB 记忆能力的独立插件,通过 Hermes 的记忆提供方接口和生命周期钩子工作。默认使用进程内嵌入式引擎,无需单独启动服务器;也可配置为连接 yantrikdb-server 的 HTTP 后端。插件向 Hermes 暴露记忆读写、检索、关系、冲突和维护等工具,并在会话结束、上下文压缩等时机运行相应钩子。检索结果包含 why_retrieved 评分理由,嵌入式模式还支持更正链和按时间点回溯。安装需要 Hermes 使用的 Python 环境中可导入插件及 YantrikDB 引擎;它不是直接面向其他 Agent 平台的通用插件。
插件将 Hermes 的记忆操作交给 YantrikDB:yantrikdb_remember 写入记忆,yantrikdb_recall 按相关性检索并返回 why_retrieved 理由,yantrikdb_relate 建立关联,yantrikdb_conflicts 与 yantrikdb_resolve_conflict 用于查看和处理冲突。yantrikdb_think 可执行整理维护;生命周期钩子还可在压缩前注入高显著性记忆、镜像 Hermes 内置记忆写入,并在会话结束时触发维护。启用相应功能后,插件还提供技能、任务、近期对话、知识缺口、触发器和知识包等工具。嵌入式后端支持通过 supersedes_rid 记录更正、用 include_superseded 查看更正链、用 as_of 查询历史状态,以及通过 yantrikdb_links 检查关系边;HTTP 后端不支持这些关系相关能力。
- 使用 Hermes 的开发者希望跨会话保留用户偏好,并在后续对话中检索。
- 长时间运行的 Hermes 编码代理需要在上下文压缩前保留重要约束。
- 维护用户资料或项目事实的团队希望发现重复内容及相互矛盾的记忆。
- 需要审计更正过程的用户希望查询某条事实何时被替代;此场景需使用嵌入式后端。
- 管理多个 Hermes 代理的运维者希望共享服务端记忆,或在同一主机进程内复用引擎。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
pip install yantrikdb-hermes-pluginpip install yantrikdb
- 环境变量
YANTRIKDB_URLYANTRIKDB_TOKEN- 配置文件
~/.hermes/hermes-agent/venv/bin/activate~/.hermes/.env
如何安装或部署这个 Agent?
快速安装需要将包安装到 Hermes 使用的 Python 环境,再注册提供方并在 Hermes 中选择它:
pip install yantrikdb-hermes-plugin
yantrikdb-hermes install
hermes memory setup若希望用插件仓库路径安装,可先激活 Hermes 虚拟环境,再单独安装引擎:
source ~/.hermes/hermes-agent/venv/bin/activate
hermes plugins install yantrikos/yantrikdb-hermes-plugin
pip install yantrikdb
hermes memory setup若选择 HTTP 后端,需要另行部署 yantrikdb-server、创建访问令牌,并在 ~/.hermes/.env 设置 YANTRIKDB_MODE=http、YANTRIKDB_URL 和 YANTRIKDB_TOKEN。默认嵌入式后端无需服务器、令牌或 GPU。
如何使用这个 Agent?
完成注册后,在 Hermes 中选择 YantrikDB 并确认状态:
hermes memory setup
hermes memory status之后可在 Hermes 对话中让代理记住或检索信息;插件通过工具如 yantrikdb_remember 和 yantrikdb_recall 执行操作。需要多用户隔离时,在 ~/.hermes/.env 启用 owner scoping:
echo "YANTRIKDB_OWNER_SCOPING=true" >> ~/.hermes/.env技能工具默认关闭,可显式启用:
echo "YANTRIKDB_SKILLS_ENABLED=true" >> ~/.hermes/.env这个 Agent 有哪些优点和局限?
- 默认进程内运行,无需单独服务器、令牌或 GPU;也提供 HTTP 后端供多实例部署。
- 检索结果附带 why_retrieved 理由,便于查看记忆的排序依据。
- 支持冲突处理、去重维护和较新的更正链及历史检索能力。
- README 给出了可运行的召回基准、测试覆盖信息和对比探测方法。
- 只为 Hermes Agent 提供原生集成;其他助手需要不同适配方式,README 提到的 MCP 支持属于另一个 YantrikDB 项目。
- 必须把插件和引擎装进 Hermes 实际使用的 Python 环境,安装和环境排查涉及多个步骤。
- 更正链、历史查询和关系边读取仅支持嵌入式后端;HTTP 部署无法使用这些能力。
- README 的 1000 条记录对比探测中,YantrikDB 测试写入 256/1000 后遇到引擎队列满错误;该项使用的是较早版本组合。
这个 Agent 与同类方案有什么区别?
与 Hermes 内置文件记忆相比,该插件增加了 YantrikDB 的语义检索、评分理由、冲突处理和维护能力。README 也提供了与 ByteRover、Hindsight、Holographic、Honcho、Mem0、OpenViking、RetainDB 和 Supermemory 的可复现实测对比;其中部分服务因缺少凭据或端点而无法验证,已测结果受探测语料和查询形式限制。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| YantrikDB Hermes 记忆插件 当前 | 72 · 存在缺口 | Agent 插件 / 技能免费 | ★ 97 | 16 天前 | Python | — |
| SwarmVault | 75 · 表现良好 | 命令行工具免费 + 模型费 | ★ 737 | 4 个月前 | TypeScript | Codex · Claude Code |
| Obsidian Wiki — AI 代理的第二大脑 | 73 · 存在缺口 | Agent 插件 / 技能免费 | ★ 3.8k | 今天 | Python | Codex · Claude Code |
| Due Diligence Agents | 69 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 139 | 3 天前 | Python | Claude API |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
安装器默认拒绝覆盖,只有明确使用 --force 才替换目标;README 给出卸载步骤,HTTP 模式的令牌配置、嵌入式默认和依赖范围也有说明。扣分原因:源码样本未展示记忆数据的加密、保留或敏感信息策略;强制覆盖和卸载会删除插件目录,虽有提示但未提供恢复机制;发布者身份未验证,维护归属主要由项目文件和作者字段说明。
CI 配置了多 Python 版本的 lint、类型检查和测试,并另设真实引擎契约作业;版本同步检查和依赖上界体现了防止漂移的措施。扣分原因:本审查不能验证这些作业实际通过;样本中版本、安装路径和更新说明有较多历史兼容细节,且没有足够完整的实现代码来确认整体行为一致。CLI 对目标已存在、Hermes 路径无效及 UI 运行错误提供具体提示,但样本未覆盖所有运行时故障。
文档明确面向 Hermes 用户,覆盖单机嵌入式、多实例 HTTP、多人 owner-scoping、长驻运行和多代理场景,并说明相关配置。扣分原因:各功能边界和触发条件分散在 README 的版本叙述中,实际是否适配具体 Hermes 版本仍需用户核对;样本没有完整展示工具调用和各项自动任务的触发实现。
仓库有 README、CLI、配置、CI、发布流程、MIT 许可证和版本变更日志入口;安装、升级、卸载、环境隔离、可选嵌入器和已知限制均有具体说明。扣分原因:README 很长且信息按多个历史版本累积,部分重要选项需要在段落间查找;维护责任有作者、问题入口和发布流程,但没有明确的响应承诺或支持时限。
产品将记忆写入、召回、冲突跟踪、维护及可解释召回集成到 Hermes,并返回 why_retrieved 等可用于判断结果的内容;文档也量化工具上下文成本并给出基准和使用示例。扣分原因:收益和竞品比较主要由项目自身陈述,样本不足以独立确认对普通用户的实际增益;工具成本和性能陈述有注明部分数字未重新测量。
README 的安装、版本和依赖说明能与 CLI、pyproject、CI 工作流相互印证;项目也给出基准脚本和版本同步检查。扣分原因:许多性能、规模和竞品主张依赖未包含在样本中的报告、测试或外部资料;描述中虽有区分测量值与旧估值的例子,但并非所有主张都有同等清晰的证据链。
- 记忆可能包含用户敏感信息;所给源码样本没有展示加密、保留期限或数据清除策略,部署前应核实数据库文件和备份的保护方式。
- README 中的性能、规模及竞品对比主要是项目方陈述,部分工具成本数字明确未重新测量;本静态评估未执行代码或验证测试结果。
- 使用 --force 更新会替换插件目录;若其中有自定义文件,README 建议先备份。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
v0.28.0 v0.28.0 — correction chains, historical recall and link traversal
发布说明摘录
Memory can now be corrected, not just appended to. - yantrikdb_remember(supersedes_rid=…) links a correction to what it replaces; default recall returns only the current head. include_superseded / as_of give the full chain or the state at an instant; new yantrikdb_links tool traverses edges. Embedded backend only; the HTTP backend refuses loudly (#98) - model2vec is a manifest hard dependency, so it survives Hermes env regeneration (#92, #96) - sentence-transformers extra gated off android/emscripten so it no longer breaks Hermes' workspace resolve (#99, #100) …在 GitHub 查看 ↗ -
v0.27.1 v0.27.1 — a missing embedder dependency says which interpreter looked where
发布说明摘录
A missing embedder dependency now names the interpreter and sys.path it searched (#92), and the README documents that embedder dependencies installed by hand are dropped when Hermes regenerates the plugin environment. Making model2vec a manifest dependency is still open in #92. No functional change otherwise.在 GitHub 查看 ↗ -
v0.27.0 v0.27.0 — a multiplexed gateway keeps each profile's YantrikDB settings to itself
发布说明摘录
Pin unchanged (yantrikdb>=0.12.1,!=0.15.0,!=0.15.1,!=0.15.2,<0.24.0). Gated against engine 0.23.1. **Anyone running a multiplexed Hermes gateway with more than one profile should take this release.** Validated live on Hermes 0.19.0: before it, a secondary profile's memories went into the launch profile's store, even when that profile's own .env configured a different one. Install note. Hermes' memory loader prefers plugins/memory/yantrikdb inside the Hermes package over $HERMES_HOME/plugins/yantrikdb. If you ever used the deprecated …在 GitHub 查看 ↗
常见问题
默认安装是否需要单独运行数据库服务器?
使用插件是否需要 API 密钥或 GPU?
记忆数据能否按用户隔离?
YANTRIKDB_OWNER_SCOPING=true 启用 owner scoping;该选项默认关闭,已有基础命名空间仍可参与读取(默认设置下)。HTTP 后端是否支持历史更正查询?
YantrikDB Hermes 记忆插件 官网是什么?
YantrikDB Hermes 记忆插件 免费吗?
YantrikDB Hermes 记忆插件 开源吗?
YantrikDB Hermes 记忆插件 安全吗?
YantrikDB Hermes 记忆插件 还在维护吗?
YantrikDB Hermes 记忆插件 是谁开发的?
谢谢反馈,我们会据此改进页面。