NevaMind-AI/memU
Personal memory across agents
memU是什么?
memU(发音为mem-you)是一个轻量级、代理驱动的个人记忆系统。它让你拥有一个共享、可搜索的、属于你自己的LLM生成知识wiki,可以跨以下范围持久化:
- 不同的聊天会话,
- 多个AI代理(ChatGPT、Claude Code、Cursor、OpenClaw、Hermes、WorkBuddy等),
- 甚至不同的设备。
memU的核心只有约500行Python,使记忆逻辑易于阅读、审计和扩展。
为什么使用它?
- 再也不丢失有用的上下文 – memU自动捕获每次代理交互中有用的部分,并将其存储为可复用的Markdown“技能”。
- 跨代理复用 – 在与一个代理(例如Claude Code)工作时学到的技能可以被另一个代理(例如Cursor)检索到,无需额外工作。
- 自托管选项 – 你可以在自己的机器上保持一切私有,或使用托管的memU Cloud服务。
- 记忆层零LLM开销 – memU只存储、嵌入和检索你(或代理)生成的Markdown;它从不自己调用LLM。
它是如何工作的?
- 主机适配器 – 一个小型二进制文件(例如
memu-codex、memu-claude-code)知道给定代理将其会话日志写入何处,以及代理读取哪个指令文件。 - 记忆 – 一个计划的后台任务读取新的会话日志,将其分割为自包含作业,并交给代理。
- 技能提取 – 代理决定是创建新技能、修补现有技能还是不采取任何行动。结果是一个描述可复用工作流的干净Markdown文件。
- 提交 – memU将技能文件写回共享存储,嵌入技能名称/描述,并为其建立索引。
- 检索 – 在代理回答新查询之前,memU注入一个
retrieve调用,根据向量相似性返回最相关的技能。
所有嵌入和向量搜索工作由可配置的后端(内存、SQLite或带pgvector的Postgres)处理。唯一涉及LLM的部分是编写技能Markdown的代理。
快速开始 / 安装
# 安装CLI(包括核心库和所有主机适配器)
pip install memu-cli # Python包
# 或使用npm/uv快捷方式
npx memu-cli --help
uvx --from memu-cli memu
- 获取API密钥 – 从memU Cloud网站https://memu.so(或为自托管模式设置自己的嵌入提供商)。
- 向代理发送一行消息(ChatGPT、Claude Code等):
技能文件指导代理完成检测主机、安装适当的二进制文件、配置Read https://memu.pro/SKILL.md, follow its instructions to install and configure memU, API Key is memu_•••••••••~/.memu/config.env以及调度桥接任务。 - 使用
<binary> doctor验证 – 它报告解析后的配置和成功的检索测试。
使用memU
- 自动检索 – 安装后,主机适配器会在每次代理响应前注入
retrieve步骤,因此无需额外命令即可获得相关技能。 - 手动检索 – 你可以直接请求技能:
memu-codex retrieve "What should I remember about this project?" # 将其替换为与你的代理匹配的二进制文件 - 开发者集成 – 在您自己的应用程序中使用
memu memorize将任意对话日志转换为memU兼容的技能Markdown。有关所需的JSONL格式,请参阅docs/developer.md。
生态系统与兼容性
| 操作系统 | 代理 | 记忆 | 检索 |
|---|---|---|---|
| macOS | ChatGPT (Work mode)、Claude Code、Cursor、OpenClaw、Hermes、WorkBuddy | ✅ | ✅ |
| Windows | 与macOS相同(有一些模型特定的注意事项) | ✅ | ✅ |
| Linux | Codex (VS Code)、Claude Code、OpenClaw | ✅/❌ | ✅ |
支持的适配器包括:
memu-codexmemu-claude-codememu-cursormemu-openclawmemu-hermesmemu-workbuddymemu-colamemu-pi- 用于任何其他基于JSONL的代理的通用
memu-agent。
添加新主机只需实现一个TranscriptSource(日志所在位置)和一个小的CLI包装器 – 核心管道是共享的。
配置
所有设置从环境变量读取,回退到~/.memu/config.env:
MEMU_DB– 向量存储的路径/DSN(默认SQLite)。MEMU_EMBED_PROVIDER–openai、jina、voyage、doubao、openrouter。MEMU_API_KEY– 提供者特定的密钥。MEMU_EMBED_MODEL– 模型名称(每个提供者有默认值)。MEMU_MEMORY_MODE–local(默认)或cloud。
运行<binary> doctor查看解析后的配置并测试检索。
许可证
Apache-2.0(宽松,适合商业使用)。
摘要
memU为你提供一个个人、与代理无关的wiki,它自动从你的LLM会话中学习,并使该知识立即可用于任何支持的AI编码助手,且代码库小巧、可检查。
相关
- 项目
- 项目
- 项目
- 项目
- 项目