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("常にTypeScriptのstrictモードを使用する", "user_preference")
results = query("TypeScriptの設定")

omega setup --hooks-only    # 自動キャプチャ + メモリの表示、MCPサーバーなし (~600MB RAM節約)

✨ 主な機能

自動キャプチャ

決定を行ったり、問題をデバッグしたりすると、OMEGAが自動的に検出して保存します。

自動表示

ファイルを編集したり、セッションを開始したりすると、OMEGAが過去のセッションから関連するメモリを表示します。

チェックポイントと再開

タスクの途中で停止しても、新しいセッションで停止したところから再開できます。

また、Claudeに明示的に何かを覚えさせることもできます:

"JWTトークンを使用し、セッションクッキーは使用しないことを覚えておいて"

しかし、OMEGAの本当の価値は、要求なしに行うことにあります。

💻 使用例

アーキテクチャ上の決定が引き継がれる

"注文サービスでは、支払い処理にACIDトランザクションが必要なため、MongoDBではなくPostgreSQLを選択したことを覚えておいて"

3週間後、新しいセッションで:

"注文サービスにキャッシュ層を追加している -- 何を知っておくべきですか？"

OMEGAはPostgreSQLの決定を自動的に表示するため、ClaudeはMongoDBスタイルのアプローチを提案しません。

ミスが教訓になる

Dockerビルドの失敗を30分間デバッグします。Claudeが解決策を見つけます:

"node_modulesボリュームマウントがコンテナのnode_modulesを上書きしていました。匿名ボリュームを追加することで修正しました。"

OMEGAはこれを教訓として自動的にキャプチャします。次に誰かが同じDockerの問題に遭遇したとき、Claudeはすでに解決策を知っています。

設定が保持される

"常に早期リターンを使用し、条件分岐を2レベル以上ネストしない。constをletよりも優先することを覚えておいて"

将来のすべてのセッションで、これらのルールが再度指示されることなく適用されます。

タスクがセッションの境界を超えて存続する

リファクタリングの途中で停止する必要がある場合:

"このタスクをチェックポイントとして保存 -- 認証ミドルウェアを新しいパターンに移行する作業を途中まで進めている"

次のセッションで:

"認証ミドルウェアのタスクを再開"

Claudeは停止したところから正確に再開します。

その他の使用例 (CLI、Python API、スクリプト): docs/examples

📚 詳細ドキュメント

他のツールとの比較

詳細な比較は omegamax.co/compare を参照してください。

無料版とPro版の比較

OMEGAはオープンコアモデルを採用しています。無料のCore版はApache-2.0ライセンスで、再ライセンスされることはありません。

Core版は完全です。 ほとんどの個人開発者はPro版を必要としないでしょう。Pro版は、複数のエージェントを同時に実行するチームに対して、マルチエージェント協調とエンタープライズ機能を提供します。

ベンチマーク

LongMemEval (ICLR 2025)で1位 -- 長期メモリシステムの学術的なベンチマークです。抽出、推論、時間的理解、および設定追跡をテストする500の質問が含まれています。

詳細と方法論は omegamax.co/benchmarks を参照してください。

主要な機能

• 12のMCPツール -- 保存、クエリ、トラバース、チェックポイント、再開、圧縮、統合など。完全なツールリファレンスは omegamax.co/docs を参照してください。
• 意味検索 -- bge-small-en-v1.5の埋め込みとsqlite-vecを使用して、高速かつ正確な検索を実現します。
• 自動キャプチャと表示 -- フックが自動的に決定と教訓を検出し、作業中に関連するメモリを表示します。
• グラフ関係 -- メモリがタイプ付きのエッジ (関連、置き換え、矛盾) でリンクされています。
• インテリジェントな忘却 -- 時間による減衰、矛盾解決、重複排除。設定とエラーは減衰の対象外です。
• 静止時の暗号化 (オプション) -- AES-256-GCMとmacOS Keychainの統合。pip install omega-memory[encrypt]
• プラグインアーキテクチャ -- エントリポイントを介して拡張可能です。

互換性

サポートされるエディタ

自動キャプチャフックは現在、Claude Codeのフックシステムでのみサポートされています。すべてのMCP互換クライアントは、12個のツールからなる完全なメモリAPIを利用できます。

PythonとOS

システム要件

利用者

OMEGAは、Claude Code、Cursor、およびWindsurfを使用し、セッション間で永続的なメモリが必要な開発者によって利用されています。個人開発者から複数のエージェントを使用するチームまで、幅広いユーザーが利用しています。

"OMEGAをインストールして忘れていました。2週間後に、Claudeのセッションが以前のセッションの情報を自動的に知っていることに気づきました。"

OMEGAを使用している場合は、PRを作成 して、ここに追加してください。

リモート/SSHセットアップ

リモートサーバー上でエージェントを実行し、任意のデバイスからSSHで接続します。OMEGAのメモリグラフはサーバー上で待機しています。

# リモートサーバー上 (GPU不要の任意のLinux VPS)
pip3 install omega-memory[server]
omega setup
omega doctor

すべてのSSHセッションは、そのサーバー上の以前のすべてのセッションの完全なメモリを持ちます。切断してもデータは保持されます。最初のクエリ後に約337 MBのRAMを使用します。外部サービスは一切使用しません。

# 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       |
               +----------------------+

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

トラブルシューティング

omega doctor がインポートでFAILを表示する場合

• リポジトリのルートから 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 --> ブロックを削除してください。

リンク

• Webサイトとドキュメント -- 完全なドキュメント、ベンチマーク、および比較ページ
• 変更履歴
• 貢献ガイド
• セキュリティポリシー
• バグ報告

スター履歴

📄 ライセンス

Apache-2.0ライセンスです。詳細は LICENSE を参照してください。無料のCore版はApache-2.0ライセンスで、再ライセンスされることはありません。