Omega Memory

欧米茄

AI代理的跨模型内存。本地优先。适用于Claude、GPT、Gemini、Cursor、爪码和任何MCP客户端。 你的代理人的大脑不应该存在于别人的服务器上，也不应该被锁定在一个提供商的服务器上。

   

______________________________________________________________________

问题

AI编码代理是无状态的。每个新会话都从零开始。这些“解决方案”要么将您锁定到一个模型提供商，要么将您的代码库上下文发送到他们的云端。

• 上下文丢失。 代理会忘记会话之间的每一个决定、偏好和架构选择。开发人员每次会话花费10-30分钟重新解释已经建立的上下文。
• 重复的错误。 如果不从过去的会话中学习，代理就会一遍又一遍地犯同样的错误。他们不记得什么有效，什么失败，或者为什么选择了一种特定的方法。
• 云内存=其他人的数据库。 像Mem0这样的服务需要API密钥，并将您的数据发送到服务器。当他们改变定价、被收购或下跌时，你的代理人积累的情报就会消失。
• 供应商锁定。 Anthropic的记忆工具仅适用于克劳德。OpenAI的内存仅适用于GPT。更换型号，失去记忆。

OMEGA解决了这个问题。完全在机器上运行的记忆、协调和学习。与每个主要的LLM和编码代理合作。没有云。没有API密钥。没有供应商锁定。

快速安装

pip install omega-memory[server]    # Full install (memory + MCP server)
omega setup                         # Downloads model, registers MCP, installs hooks
omega doctor                        # Verify everything works

克劳德桌面版

pip install omega-memory[server]
omega setup --client claude-desktop

这将OMEGA注册为Claude Desktop配置中的MCP服务器。重新启动Claude Desktop以激活。

光标、爪码、风帆、Cline、Codex

pip install omega-memory[server]
omega setup --client cursor      # or: claw-code, windsurf, cline, codex

Library-only install (no MCP server)

如果你只需要OMEGA作为脚本、CI/CD或自动化的Python库：

pip install omega-memory    # Core only, no MCP server process

from omega import store, query, remember

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

这为您提供了完整的存储和检索API，而无需运行MCP服务器（轻约50 MB，无后台进程）。钩子仍然有效：

omega setup --hooks-only    # Auto-capture + memory surfacing, no MCP server (~600MB RAM saved)

来自源头

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

omega setup 将：

1. 创建 ~/.omega/ 目录
2. 下载ONNX嵌入模型（约90 MB）至 ~/.cache/omega/models/
3. 注册 omega-memory 作为MCP服务器（克劳德代码自动检测，或指定--client）
4. 将会话挂钩安装到 ~/.claude/settings.json
5. 添加OMEGA块 ~/.claude/CLAUDE.md

60秒快速入门

OMEGA通过自然语言工作-没有API调用，没有配置。跟克劳德谈谈。

1.告诉克劳德记住一件事：

请记住，身份验证系统使用JWT令牌，而不是会话Cookie

克劳德将其存储为具有语义嵌入的永久记忆。

2.结束会议。打开一个新的。

3.询问：

“我对身份验证做出了什么决定？”

OMEGA会自动显示相关内存：

Found 1 relevant memory:
  [decision] "The auth system uses JWT tokens, not session cookies"
  Stored 2 days ago | accessed 3 times

就是这样。记忆会在会话中持续存在，随着时间的推移而积累，并在相关时自动出现——即使你没有明确要求。

主要特点

• 记忆与学习 --使用语义搜索存储决策、经验教训、错误模式和偏好。克劳德回忆起重要的事情，而无需你每次都解释一切。25种内存工具，包括压缩、整合、时间线、图遍历和上下文虚拟化（检查点/恢复）。

• 多智能体协调 *（欧米茄pro）* --文件和分支锁定、会话管理、具有依赖关系的任务队列、意图广播和代理到代理的消息传递。29个协调工具，防止代理覆盖彼此的工作。

• 智能LLM路由 *（欧米茄pro）* --将任务和路线分类到最佳模型。编程→ 克劳德·索内特。快速编辑→ Llama 8b的价格是原来的1/60。1M令牌上下文→ 双子座闪光。5个提供商，4种优先级模式，低于2ms的意图分类。

• 知识库 *（欧米茄pro）* --通过语义组块将PDF、markdown、网页和文本文件摄取到可搜索的知识库中。

• 实体登记处 *（欧米茄pro）* --具有关系、层次结构和实体范围内存/配置文件/文档的多实体企业内存。

• 安全配置文件 *（欧米茄pro）* --AES-256加密个人数据存储与macOS Keychain集成。

欧米茄如何比较

*Anthropic的内存工具在客户端存储数据，但需要Claude API调用所有内存操作。OMEGA完全在设备上运行，包括嵌入式（ONNX）。*

人择记忆是为了人择。OMEGA适合所有人。

建筑

     Claude Code  ·  Cursor  ·  Claw Code  ·  Any MCP Client
               │         │         │              │
               └─────────┴─────┬───┴──────────────┘
                               │ stdio/MCP
               ┌───────────────▼─────────────┐
               │   OMEGA MCP Server   │
               │   25 core tools      │
               └──┬──────────────────┘
                  │
         ┌────────▼──────────────┐
         │ Core Memory Engine    │
         │ (semantic search,     │
         │  embeddings, graphs)  │
         └─────┬─────────────────┘
               │
               ▼
         ┌──────────────────────────────────────┐
         │         omega.db (SQLite)             │
         │  memories | edges | embeddings        │
         └──────────────────────────────────────┘

单一数据库，模块化处理程序。可选模块（协调、路由器、实体、知识、配置文件）可通过以下方式获得 欧米茄pro 并注册到同一服务器进程中。没有单独的守护进程，没有微服务。

MCP工具参考

OMEGA在Claude Code中作为MCP服务器运行。核心包提供25个内存工具。 欧米茄pro 添加了协调、路由、实体、知识和配置文件工具。

内存（25个工具）

omega pro的附加工具

命令行界面

Advanced Details

钩子（7个进程，11个处理程序）

所有钩子通过以下方式发送 fast_hook.py → 守护进程UDS套接字，具有失败打开语义。

使用omega pro，其他协调处理程序会自动注册：会话生命周期、文件/分支声明保护、心跳和git推送保护。

存储

搜索管道

1. 向量相似性 通过sqlite-vc（余弦距离，384维bge-small-en-v1.5）
2. 全文搜索 通过FTS5（快速关键字匹配）
3. 类型加权评分 （决策/经验教训加权2倍）
4. 上下文重新排序 （通过标签、项目和内容匹配进行增强）
5. 去重 在查询时

内存生命周期

• 去重：SHA256哈希（精确）+嵌入相似度0.85+（语义）+每种类型的Jaccard
• 进化：类似的内容（55-95%）为现有的记忆增添了新的见解
• 生存时间：课程摘要在1天后过期，课程/偏好是永久性的
• 自动关联：创建 related 前3个相似记忆的边缘（相似度>=0.45）
• 压实：对相关记忆进行分类和总结

内存占用

• 启动：约31 MB RSS
• 首次查询后（加载ONNX型号）：~337 MB RSS
• 数据库：约10.5 MB，约242个内存

什么会被修改

omega setup 在外部修改这些文件 ~/.omega/:

• ~/.claude.json --添加 omega-memory MCP服务器入口
• ~/.claude/settings.json --添加钩子条目
• ~/.claude/CLAUDE.md --添加托管 `` 块

所有的变化都是幂等的。

故障排除

omega doctor 导入时显示失败：

• 确保 pip install -e ".[server]" 从repo根目录
• 检查 python3 -c "import omega" 作品

MCP服务器启动失败：

• 跑 pip install omega-memory[server] （the [server] 额外包括MCP包）

MCP服务器未注册：

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

钩子不响：

• 检查 ~/.claude/settings.json 有欧米茄挂钩条目
• 检查 ~/.omega/hooks.log 对于错误

发展

pip install -e ".[server,dev]"
pytest tests/                # 2198+ tests
ruff check src/              # Lint

卸载

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

从中手动删除OMEGA条目 ~/.claude/settings.json 和那个 ` 阻止来自 ~/.claude/CLAUDE.md`.

贡献

• 贡献指南
• 安全策略
• 更新日志
• 报告Bug

许可证

阿帕奇-2.0。看 许可证.