caspianmoon/memoripy

这是什么？

核心功能

• 01准入策略在自动写入进入持久存储前进行拒绝、延后或隔离处理。
• 02双时态、不可变的版本历史，可分别查询当前与历史事实。
• 03召回阶段融合多条检索通道，并为每条结果附上 receipt 与引用。
• 04支持按用户、智能体、运行、项目、组织和命名空间进行作用域隔离。
• 05提供 audit、inspect、eval、recover 等命令行工具，用于维护记忆库。
• 06内置官方 MCP 服务器和带 Bearer Token 认证的 HTTP 服务。

适用场景

• 为个人或面向客户的智能体提供会随事实变化而更新的长期记忆。
• 在迁移前检查已有智能体记忆库中过时、重复或缺乏证据的条目。
• 通过带认证的自托管网关为多个租户分别托管智能体记忆，并使用检查器界面查看。
• 让支持 MCP 的客户端通过限定作用域的令牌访问本地记忆库。

快速上手

1. 1

   从源码安装 v4

   pip install "git+https://github.com/caspianmoon/memoripy.git@v4"
2. 2

   在 Python 中创建 Memory 存储并写入一条记忆

使用前须知

• !v4 目前在分支上开发，PyPI 稳定版可能仍指向旧版 API。
• !从源码安装需要 git，且不是已发布的软件包安装方式。

收录于专题

标签

常见问题

memoripy 是什么？

面向 AI 智能体的本地记忆运行时，负责过滤写入、追踪事实变化并解释每条召回结果的依据。 Memoripy 是为 AI 智能体提供的本地记忆层。写入前会先经过准入策略，拒绝或隔离无关内容、疑似密钥以及嵌入在不可信内容中的指令，避免噪声进入长期记忆。记录采用双时态和不可变版本管理，事实变化（例如搬家）会取代旧记录，而历史证据仍可查询。

memoripy 可以免费使用吗？用的什么许可证？

memoripy 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

memoripy 还在维护吗？

半年内有更新。memoripy 最近一次提交是在 2026年8月17日。

memoripy 适合用来做什么？

为个人或面向客户的智能体提供会随事实变化而更新的长期记忆。 在迁移前检查已有智能体记忆库中过时、重复或缺乏证据的条目。 通过带认证的自托管网关为多个租户分别托管智能体记忆，并使用检查器界面查看。 让支持 MCP 的客户端通过限定作用域的令牌访问本地记忆库。

memoripy 怎么安装和运行？

从源码安装 v4: pip install "git+https://github.com/caspianmoon/memoripy.git@v4" 在 Python 中创建 Memory 存储并写入一条记忆

在哪里获取 memoripy？

源代码和安装说明在 GitHub 上：https://github.com/caspianmoon/memoripy