Omega Memory

🚀 OMEGA

为AI编码代理提供持久内存。 您的代理可以记住决策、从错误中学习，并能从上次中断的地方继续工作。

🇨🇳 中文 | 🇯🇵 日本語 | 🇰🇷 한국어 | 🇧🇷 Português | 🇪🇸 Español | 🇫🇷 Français | 🇩🇪 Deutsch | 🇷🇺 Русский

它是 Mem0 的开源、本地优先替代方案。 无需API密钥，无需云端服务，您的数据将保留在本地机器上。

pip3 install omega-memory[server]
omega setup

可与 Claude Code | Cursor | Windsurf | Zed | 任何MCP客户端配合使用

🚀 快速开始

pip3 install omega-memory[server]   # 从PyPI安装（包含MCP服务器）
omega setup                         # 自动配置Claude Code并设置钩子
omega doctor                        # 验证一切是否正常工作

⚠️ 重要提示

omega setup 会下载嵌入模型并配置您的编辑器，请不要跳过此步骤。

就这么简单。启动一个新的Claude Code会话，并说 “记住我们始终使用提前返回，并且嵌套不超过2层。” 关闭会话，再打开一个新会话，询问 “我的代码风格偏好是什么？” OMEGA会立即回忆起来。

如果使用其他编辑器？ 使用 pip3 install omega-memory[server] 进行安装，然后：

omega setup --client cursor          # 写入 ~/.cursor/mcp.json
omega setup --client windsurf        # 写入 ~/.codeium/windsurf/mcp_config.json
omega setup --client zed             # 写入 ~/.config/zed/settings.json

{
  "mcpServers": {
    "omega-memory": {
      "command": "python3",
      "args": ["-m", "omega.server.mcp_server"]
    }
  }
}

pipx install omega-memory[server]              # 推荐全局安装（无需虚拟环境）
pip3 install omega-memory[server]              # 标准安装（可能需要虚拟环境）
python3 -m pip install omega-memory[server]    # 如果没有pip3可用

pip3 install omega-memory    # 仅安装核心库，无MCP服务器进程

from omega import store, query, remember

store("Always use TypeScript strict mode", "user_preference")
results = query("TypeScript preferences")

omega setup --hooks-only    # 自动捕获和记忆展示，无MCP服务器（节省约600MB RAM）

✨ 主要特性

• 12个MCP工具 -- 存储、查询、遍历、检查点、恢复、压缩、合并等。完整的工具参考请见 omegamax.co/docs。
• 语义搜索 -- 使用bge-small-en-v1.5嵌入模型和sqlite-vec实现快速、准确的检索。
• 自动捕获和展示 -- 通过钩子自动检测决策和经验教训，并在工作过程中展示相关记忆。
• 图关系 -- 记忆通过类型化的边（相关、取代、矛盾）相互关联。
• 智能遗忘 -- 支持时间衰减、冲突解决和去重。偏好和错误信息不会衰减。
• 静态加密 (可选) -- 使用AES-256-GCM加密，并与macOS钥匙串集成。使用 pip install omega-memory[encrypt] 进行安装。
• 插件架构 -- 可通过入口点进行扩展。

📦 安装指南

标准安装

pip3 install omega-memory[server]
omega setup

其他安装方式

• 全局安装：

pipx install omega-memory[server]

• 仅安装核心库：

pip3 install omega-memory

从源码安装

git clone https://github.com/omega-memory/omega-memory.git
cd omega-memory
pip3 install -e ".[server,dev]"
omega setup

💻 使用示例

基础用法

from omega import store, query, remember

store("Always use TypeScript strict mode", "user_preference")
results = query("TypeScript preferences")

高级用法

在实际开发中，您可以使用OMEGA的各种功能来管理编码过程中的记忆。例如，在处理复杂的架构决策时：

# 存储架构决策
store("We chose PostgreSQL over MongoDB for the orders service because we need ACID transactions for payment processing.", "architectural_decision")

# 查询相关记忆
results = query("Orders service database choice")

📚 详细文档

它的作用

执行 omega setup 后，OMEGA会在后台运行，无需额外学习命令。

• 自动捕获 -- 当您做出决策或调试问题时，OMEGA会自动检测并存储相关信息。
• 自动展示 -- 当您编辑文件或启动会话时，OMEGA会展示过去会话中的相关记忆。
• 检查点和恢复 -- 您可以在任务进行到一半时暂停，然后在新会话中从上次中断的地方继续。

您也可以明确告诉Claude记住某些信息，例如：

"记住我们使用JWT令牌，而不是会话cookie"

但OMEGA真正的价值在于它在无需提示的情况下所做的工作。

更多示例

• 架构决策延续：

"记住：我们为订单服务选择了PostgreSQL而不是MongoDB，因为我们在支付处理中需要ACID事务。"

三周后，在新会话中：

"我要为订单服务添加一个缓存层 -- 我应该了解什么？"

OMEGA会自动展示选择PostgreSQL的决策，这样Claude就不会建议采用MongoDB风格的方法。

• 错误成为经验教训： 您花了30分钟调试Docker构建失败的问题，Claude找出了原因：

"node_modules卷挂载覆盖了容器的node_modules。通过添加匿名卷解决。"

OMEGA会自动将此作为经验教训存储。下次有人遇到相同的Docker问题时，Claude已经知道解决方案。

• 偏好持久化：

"记住：始终使用提前返回。条件语句嵌套不超过2层。优先使用 const 而不是 let。"

以后的每个会话都会遵循这些规则，无需再次提醒。

• 任务跨会话延续： 您在重构过程中需要暂停：

"设置检查点 -- 我正在将认证中间件迁移到新模式，已经完成了一半。"

下一个会话：

"恢复认证中间件任务。"

Claude会从上次中断的地方继续。

更多示例（CLI、Python API、脚本编写）请见：docs/examples

功能对比

完整对比请见 omegamax.co/compare。

免费版与专业版对比

OMEGA采用开源核心模式。免费的核心版本采用Apache-2.0许可证，且永远不会更改许可证。

核心版功能完整，大多数个人开发者永远不需要专业版。专业版为运行多个并发代理的团队解锁了多代理协调和企业级功能。

兼容性

支持的编辑器

目前自动捕获钩子仅在Claude Code的钩子系统中受支持。所有与MCP兼容的客户端都可以使用完整的12个工具的记忆API。

Python和操作系统

系统要求

谁在使用OMEGA

OMEGA被使用Claude Code、Cursor和Windsurf的开发者所使用，他们需要跨会话的持久内存。从个人开发者到运行多代理工作流的团队都在使用。

"我安装了OMEGA后就没再管它。两周后我才意识到我的Claude会话......记住了之前会话中的信息。"

如果您正在使用OMEGA，请 提交PR 将自己添加到这里。

远程/SSH设置

您可以在远程服务器上运行代理，然后从任何设备通过SSH连接。OMEGA的记忆图会在服务器上等待您。

# 在您的远程服务器上（任何Linux VPS -- 无需GPU）
pip3 install omega-memory[server]
omega setup
omega doctor

每个SSH会话都可以完整记忆该服务器上之前的所有会话。即使断开连接也不会丢失。首次查询后约占用337 MB内存，无需外部服务。

# 在PowerShell（管理员权限）中运行
wsl --install

# 在WSL终端中运行
sudo apt update && sudo apt install -y python3 python3-pip python3-venv
python3 --version   # 应显示为3.11+

sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update && sudo apt install -y python3.12 python3.12-venv

pip3 install omega-memory[server]
omega setup
omega doctor

               +---------------------+
               |    Claude Code       |
               |  (or any MCP host)   |
               +----------+----------+
                          | stdio/MCP
               +----------v----------+
               |   OMEGA MCP Server   |
               |   12 memory tools    |
               +----------+----------+
                          |
               +----------v----------+
               |    omega.db (SQLite) |
               | memories | edges |   |
               |     embeddings       |
               +----------------------+

🔧 技术细节

基准测试

在 LongMemEval（ICLR 2025）学术基准测试中排名第一，该测试用于评估长期记忆系统。通过500个问题测试提取、推理、时间理解和偏好跟踪能力。

详细信息和方法请见 omegamax.co/benchmarks。

📄 许可证

本项目采用Apache-2.0许可证。详情请见 LICENSE。免费的核心版本采用Apache-2.0许可证，且永远不会更改许可证。

🔗 相关链接

• 网站与文档 -- 完整的文档、基准测试和比较页面
• 更新日志
• 贡献指南
• 安全策略
• 报告问题

⭐ 星标历史

🛠️ 故障排除

omega doctor 显示导入失败

• 确保从仓库根目录执行 pip3 install -e ".[server]"
• 检查 python3 -c "import omega" 是否可以正常工作

MCP服务器无法启动

运行 pip3 install omega-memory[server]（[server] 额外包含MCP包）

MCP服务器未注册

claude mcp add -s user omega-memory -- python3 -m omega.server.mcp_server

钩子未触发

• 检查 ~/.claude/settings.json 中是否有OMEGA钩子条目
• 检查 ~/.omega/hooks.log 中是否有错误信息

🚧 开发

pip3 install -e ".[server,dev]"
pytest tests/
ruff check src/

🗑️ 卸载

claude mcp remove omega-memory
rm -rf ~/.omega ~/.cache/omega
pip3 uninstall omega-memory

手动从 ~/.claude/settings.json 中移除OMEGA条目，并从 ~/.claude/CLAUDE.md 中移除 <!-- OMEGA:BEGIN --> 块。