MemPalace 记忆库
把对话和项目资料原文存入本地记忆库,并用语义搜索为 AI 会话找回相关内容。
- Star 数
- ★ 60k
- 最近更新
- 今天
- License
- MIT
- 主语言
- Python
- FA 评分
- 74/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude CodeOpenAI API · Claude API(部分支持)
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 使用 Claude Code 的开发者,希望将历史会话导入本地并在后续会话中搜索。
- 不适合
- 需要 Android 原生 Termux 安装的用户
- 要求所有检索与重排都不使用外部模型服务的团队
- 源码审查
- 74/100 · 存在缺口
这个 Agent 能做什么,适合哪些场景?
MemPalace 是一个本地优先的 AI 记忆系统,将对话历史和项目文件按原文存储,不做摘要、提取或改写。默认使用 ChromaDB,通过语义搜索检索内容,并以 wing、room 和 drawer 组织人员、项目、主题与原始资料。用户可用 CLI 导入和搜索资料,也可通过 MCP server 让兼容客户端读取和管理记忆;Python API 也有文档说明。系统支持多个可选存储后端,并包含基于本地 SQLite 的时序实体关系图。默认检索和基准测试路径不需要 LLM 或 API 密钥,但首次使用嵌入模型需要下载;可选的 LLM 重排或远程嵌入服务会引入相应模型或服务依赖。
使用 mempalace mine 从项目文件或 Claude Code 会话读取内容,并将原文存入 palace;mempalace search 按语义查找相关记忆,mempalace wake-up 为新会话加载上下文。用户可通过 mempalace audit 检查记忆库组织情况。MCP server 提供记忆库读写、知识图谱、跨 wing 导航、drawer 管理、agent 日记和协调工具。系统还提供 mempalace sweep,可将对话逐条保存为原文 drawer;选择启用 LLM 重排时,会用模型重新排序检索到的候选内容。
- 使用 Claude Code 的开发者,希望将历史会话导入本地并在后续会话中搜索。
- 需要跨项目找回决策或技术讨论的工程团队,可按项目 wing 和主题 room 管理原文。
- 使用 MCP 客户端的开发者,希望让助手读取或更新本地记忆库。
- 需要把项目目录内容建立语义索引、再用自然语言问题检索的个人或团队。
- 希望在本地维护带有效时间范围的实体关系信息,并用 SQLite 查询时间线的用户。
如何安装或部署这个 Agent?
推荐用 uv 将 CLI 安装在隔离环境中;初始化 palace 后即可导入项目内容。也可用 pipx 安装,或在已激活的虚拟环境中用 pip 安装。首次需要嵌入的操作会下载所选模型。若使用 Docker,需要将持久化目录挂载到 /data;MCP 客户端配置示例如下:
uv tool install mempalace
mempalace init ~/projects/myappDocker MCP server 配置:
{
"mcpServers": {
"mempalace": {
"command": "docker",
"args": [
"run", "-i", "--rm",
"-v", "mempalace-data:/data",
"-v", "/absolute/path/to/.claude/projects:/transcripts:ro",
"ghcr.io/mempalace/mempalace"
]
}
}
}如何使用这个 Agent?
将项目文件或 Claude Code 会话导入 palace,然后按问题检索;新会话可加载已有上下文。会话目录和项目路径需替换为实际路径。Claude Code 会话示例:
mempalace mine ~/projects/myapp
mempalace mine ~/.claude/projects/ --mode convos
mempalace search "why did we switch to GraphQL"
mempalace wake-up
mempalace audit这个 Agent 有哪些优点和局限?
- 默认保存对话原文,支持语义搜索,不依赖摘要来保留细节。
- 默认 ChromaDB 可本地运行;README 报告 LongMemEval 原始检索在 500 道题上达到 96.6% R@5,且该路径无需 LLM。
- 存储后端可选 ChromaDB、sqlite_exact、rust_exact、Milvus、Qdrant 和 pgvector。
- 提供 MCP 工具、CLI、Python API,以及面向 Claude Code 和 Codex CLI 的自动保存 hooks。
- 需要 Python 3.10+;默认嵌入模型需要下载,README 提到模型占用约 30 MB 或约 300 MB。
- Android 原生 Termux 安装不受支持;Android ARM64 用户需使用 Debian PRoot 容器。
- 部分后端需要额外安装或配置服务;启用远程嵌入或 LLM 重排还需相应服务或模型。
- Docker Linux bind mount 的目录必须能被镜像内 uid 1000 读取;本地原生安装也需要管理 palace、配置和模型文件。
这个 Agent 与同类方案有什么区别?
README 将 ChromaDB 描述为默认后端,并列出 sqlite_exact、rust_exact、Milvus、Qdrant 和 pgvector 作为可选后端。项目未提供与 Mem0、Mastra、Hindsight、Supermemory 或 Zep 的可比基准,因此不据此作性能排名。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| MemPalace 记忆库 当前 | 74 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 60k | 今天 | Python | Codex · Claude Code |
| Remnic 智能体记忆 | 85 · 表现良好 | 命令行工具免费 + 模型费 | ★ 228 | 1 天前 | TypeScript | ChatGPT · Codex · Claude Code · OpenAI API |
| Ori Mnemos | 80 · 表现良好 | 命令行工具免费 | ★ 331 | 19 天前 | TypeScript | Claude Code · OpenAI API · Claude API |
| GraphMind 代码知识图谱 | 64 · 存在缺口 | 桌面应用免费版 + 付费版 | ★ 216 | 5 天前 | Rust | Claude Code · Claude.ai |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
README 说明默认本地存储、可选远程嵌入、容器挂载边界和只读挖掘;升级检查默认关闭且需要用户授权。不过 MCP 提供大量读写与协调工具,敏感记忆没有显示加密或细粒度访问控制,因此最小权限、敏感数据处理和外部副作用未满分。安全策略给出私下报告渠道,README 与 authored-at 文档也说明来源时间字段及其局限;但维护责任和发布者身份并不清楚,不能据此进一步加分。
README、配置和 CI 文件共同说明多后端、平台支持、依赖及测试门槛;CI 也披露 Windows 上特定 Chroma 瞬时故障并限定重试。常见依赖有版本范围而非完全锁定,错误提示证据主要是安装说明中的具体故障示例,尚不足以证明全面的运行时诊断,因此均为良好但非满分。
文档覆盖开发者、对话记忆、项目文件、MCP、Docker、团队服务、不同向量后端和多平台;明确指出哪些后端需选装、哪些能力有回退、GPU 镜像的架构限制及 Claude 自动保存前提。三个技能的用途和设置触发路径有说明,但未提供技能正文来证明所有触发条件都足够精确。
README 按安装、后端、快速开始、基准、工具和文档组织,命令与环境变量示例丰富,并明确列出 Termux、ARM GPU 等限制;MIT 许可文本完整。版本号可从多个文件核对,变更日志有链接但未在所给材料中展示;FAQ 和维护者责任也没有充分材料,故不满分。
CLI、MCP、结构化记忆和搜索结果字段可直接用于日常操作;README 给出多组基准数值及复现入口,并避免不等指标的跨项目比较。相对价值主要由项目自身声明和所引用的结果文件支持,所给材料没有结果文件或对照复核;成本信息指出模型下载和本地磁盘需求,但没有完整的资源成本测量。
README 将基准、结果文件、复现命令和方法文档相互指引;authored-at 文档清楚区分导入时间、推断日期和可验证作者日期,并给出示例与回填步骤。证据链较清晰,但本次材料未包含基准结果文件、完整变更日志或技能正文,因而跨来源印证只能给部分分。
- 基准数字来自项目 README 和其指向的仓库材料;本次静态审查未运行复现流程,也未独立核验结果。
- 记忆库可能包含敏感对话;所给文件未说明静态加密或细粒度访问控制。远程嵌入、模型下载和服务端后端会改变数据流,应按配置确认边界。