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 --> 塊。