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。

它是如何工作的?

  1. 主机适配器 – 一个小型二进制文件(例如memu-codex、memu-claude-code)知道给定代理将其会话日志写入何处,以及代理读取哪个指令文件。
  2. 记忆 – 一个计划的后台任务读取新的会话日志,将其分割为自包含作业,并交给代理。
  3. 技能提取 – 代理决定是创建新技能、修补现有技能还是不采取任何行动。结果是一个描述可复用工作流的干净Markdown文件。
  4. 提交 – memU将技能文件写回共享存储,嵌入技能名称/描述,并为其建立索引。
  5. 检索 – 在代理回答新查询之前,memU注入一个retrieve调用,根据向量相似性返回最相关的技能。

所有嵌入和向量搜索工作由可配置的后端(内存、SQLite或带pgvector的Postgres)处理。唯一涉及LLM的部分是编写技能Markdown的代理。


快速开始 / 安装

# 安装CLI(包括核心库和所有主机适配器)
pip install memu-cli          # Python包
# 或使用npm/uv快捷方式
npx memu-cli --help
uvx --from memu-cli memu
  1. 获取API密钥 – 从memU Cloud网站https://memu.so(或为自托管模式设置自己的嵌入提供商)。
  2. 向代理发送一行消息(ChatGPT、Claude Code等):
    Read https://memu.pro/SKILL.md, follow its instructions to install and configure memU, API Key is memu_•••••••••
    
    技能文件指导代理完成检测主机、安装适当的二进制文件、配置~/.memu/config.env以及调度桥接任务。
  3. 使用<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-codex
  • memu-claude-code
  • memu-cursor
  • memu-openclaw
  • memu-hermes
  • memu-workbuddy
  • memu-cola
  • memu-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编码助手,且代码库小巧、可检查。

相关

  • 项目
  • 项目
  • 项目
  • 项目
  • 项目