PowerMem

June 23, 2026 · View on GitHub

AI アプリケーションとエージェント向けの、永続化・自己進化型のメモリ層。

PyPI version PyPI downloads Python 3.11+ License Apache 2.0 GitHub Discord

English · 中文 · 日本語

PowerMem はベクトル・全文・グラフ検索に LLM 駆動のメモリ抽出とエビングハウス型の時間減衰を組み合わせます。経験 (Experience) + スキル (Skill) の二層蒸留による自己進化型メモリ、マルチエージェント分離、ユーザープロフィール、そしてテキスト/画像/音声のマルチモーダル信号を標準搭載しています。

ベンチマーク

LOCOMO

指標PowerMemベースライン改善
精度87.79%52.9%+65.9%
検索 p95 遅延1.44 s17.12 s-91.6%
トークン~0.9 k26 k-96.5%

AppWorld

指標PowerMemベースライン改善
通過率39%24%+62.5%
平均ステップ6.29.5-34.7%
総トークン1.74 M2.56 M-32.0%

再現スクリプト: benchmark/。背後の仕組み: 経験 + スキル 二層蒸留 + 4 経路ハイブリッド検索 + LLM 自動マージ（API: memory.distill_all() / add_skill / add_experience / search_*、サンプル examples/experience_skill_usage.py）。

連携 — クライアントを選んで一行で接続

PowerMem は主要な AI クライアント向けに公式プラグインとセットアップガイドを提供します。いずれも同じバックエンド（HTTP サーバー、MCP サーバー、またはローカルの pmem CLI）を指すため、クライアントごとに設定スキーマを書き直す必要はありません。すべてのエージェントが同じメモリサーバーを共有します。

AI エージェントと IDE

Claude Code
Claude Code		 Cursor
Cursor		 VS Code
VS Code		 Codex
Codex		 Windsurf
Windsurf		 GitHub Copilot
GitHub Copilot
Qoder
Qoder		 OpenCode
OpenCode		 OpenClaw
OpenClaw		 Claude Desktop
Claude Desktop		 Cline
Cline

SDK とアプリ

アプリ / フレームワーク詳細
Python SDKpip install powermem、クイックスタート を参照
LangChain / LangGraphpip install powermem、LangChain ガイド を参照
Go アプリSDK
Java アプリSDK
TypeScript アプリSDK
任意の MCP クライアントpowermem-mcp sse（デフォルト :8848）、MCP クライアントガイド
HTTP REST アプリpowermem-server --host 0.0.0.0 --port 8848、API サーバー

OpenClaw（ClawdBot）

OpenClaw はプラグイン memory-powermem によって長期メモリを獲得します。

openclaw plugins install memory-powermem

デフォルトは CLI モード — プラグインが同梱の pmem を呼び出し、~/.openclaw/ 配下の SQLite に書き込み、OpenClaw が既に注入しているモデルを再利用します。別サーバーも追加の .env も不要です。チーム共有の PowerMem API を使う場合は HTTP モード に切り替えます（プラグイン README の requestConfig.memory_db を参照）。

詳細ガイド: OpenClaw 連携。

PowerMem と OpenClaw

Claude Code

最速の手順 — Claude Code にセットアップさせる

まずコードを取得してディレクトリに入ります:

git clone https://github.com/oceanbase/powermem
cd powermem

ターミナルで Claude Code を開き、次の一行を貼り付けます:

Read and follow apps/claude-code-plugin/SETUP.md to set up PowerMem memory for Claude Code.

Claude Code は apps/claude-code-plugin/SETUP.md を読み、必要な秘密情報だけを尋ね、エンドツーエンドで設定を完了します。

手動セットアップ

手で配線したい場合は、環境変数、MCP モード、remember / recall スキル、Windows フック、トラブルシューティング、アンインストールまでの手順を docs/integrations/claude_code.md にまとめています。

Cursor、VS Code、Windsurf、GitHub Copilot、Qoder

推奨 — IDE エージェントにセットアップさせる

まずコードを取得してディレクトリに入ります:

git clone https://github.com/oceanbase/powermem
cd powermem

IDE の AI エージェントウィンドウに次の一行を貼り付けます:

Read and follow apps/vscode-extension/SETUP.md to setup PowerMem

エージェントは apps/vscode-extension/SETUP.md に従います。再利用可能な powermem-server HTTP API バックエンドを優先し、HTTP が使えない場合のみ MCP にフォールバックし、無関係なツールではなく現在の IDE/クライアントだけを設定します。

手動セットアップ

手で配線する場合は IDE 別ガイドを参照:

クライアント詳細
VS Codedocs/integrations/vs_code.md
Cursordocs/integrations/cursor.md
Windsurfdocs/integrations/windsurf.md
GitHub Copilotdocs/integrations/github_copilot.md
Qoderdocs/integrations/qoder.md

同じ拡張は Query memories、Add selection to memory、Quick note、およびステータスバーの Dashboard も提供します。詳細は apps/vscode-extension/README.md と VS Code ガイド。

任意の MCP クライアント

Claude Desktop、Codex、Cline、OpenCode、Roo Code、Goose、その他 MCP 対応クライアント向けです。MCP Client モードを使用してください。

まずコードを取得してディレクトリに入ります:

git clone https://github.com/oceanbase/powermem
cd powermem

MCP クライアントまたは IDE の AI エージェントウィンドウに次の一行を貼り付けます:

Read and follow apps/mcp-client/SETUP.md to setup PowerMem

エージェントは apps/mcp-client/SETUP.md に従います。powermem-mcp を直接使い、ポート 8848 の SSE を優先し、必要な場合のみ streamable HTTP または stdio にフォールバックし、対象の MCP クライアントだけを設定します。

手で配線する場合は 汎用 MCP クライアントガイド を参照。後から削除する場合は apps/mcp-client/UNINSTALL.md。公開ツール: add_memory、search_memories、get_memory_by_id、update_memory、delete_memory、delete_all_memories、list_memories。詳細: MCP Server。クライアント別メモ: Cline、Codex、OpenCode。

LangChain & LangGraph

pip install powermem langchain langchain-openai

エンドツーエンドで実行できるサンプル:

フレームワーク全体のガイド: LangChain と LangGraph 連携。

SDK

言語パッケージ / リポジトリ
Pythonpip install powermem（本リポジトリ）
Goob-labs/powermem-go
Javaob-labs/powermem-java
TypeScriptob-labs/powermem-ts

クイックスタート（Python SDK）

前提: .env.example を .env にコピーし、LLM の API キーだけを設定してください。ゼロコンフィグのローカルストレージを使う場合は seekdb extra（pip install "powermem[seekdb]"、または server との組み合わせ）をインストールしてください。これにより、デフォルトの OceanBase プロバイダは host 未設定時に 埋め込み seekdb を起動できます。seekdb をインストールしない場合は、OCEANBASE_HOST でリモート OceanBase クラスタを指定するか、sqlite / postgres に切り替えてください。デフォルトの embedder はローカル実行の all-MiniLM-L6-v2（384 次元）で、API キー不要・初回利用時に自動ダウンロードされます。プロバイダ切り替えや高度な設定が必要な場合は .env.example.full をコピーしてください。コンポーネントごとに全ての設定項目がまとめられています。インストール後は pmem config init で対話的に同じ設定を生成できます。詳しくは はじめに を参照してください。

インストール

# コアのみ（SDK。CLI/server/seekdb は含まない）
pip install powermem

# CLI付き（pmem / powermem-cli）
pip install "powermem[cli]"

# HTTP API Server と MCP サポート（powermem-server / powermem-mcp。seekdb はインストールしない）
pip install "powermem[server]"

# seekdb 付き（ゼロコンフィグのローカルストレージ / embedder に必要）
pip install "powermem[seekdb]"

# HTTP API Server + MCP サポート + seekdb
pip install "powermem[server,seekdb]"

# 一般的なローカル全部入りインストール
pip install "powermem[cli,server,seekdb]"

SDK サンプル

設定済みの .env があるディレクトリで実行します:

from powermem import Memory, auto_config

memory = Memory(config=auto_config())

memory.add("ユーザーはコーヒーが好き", user_id="user123")

for r in memory.search("ユーザー設定", user_id="user123").get("results", []):
    print("-", r.get("memory"))

詳しくは はじめに を参照。

CLI（pmem、1.0+）

pmem memory add "ユーザーはダークモードを好む" --user-id user123
pmem memory search "設定" --user-id user123
pmem shell                           # 対話 REPL

詳細は CLI 使用ガイド。

HTTP API Server と Dashboard

SDK と同じ .env を使用。Dashboard は /dashboard/ 以下に提供されます。

powermem-server --host 0.0.0.0 --port 8848

ローカルの対話型ターミナルでは、サーバーの準備完了後に Dashboard がデフォルトブラウザーで自動的に開きます。手動で http://localhost:8848/dashboard/ にアクセスして、メモリの閲覧、分析データの表示、システムヘルスの監視もできます。自動オープンを無効にするには --no-open-browser、出力をリダイレクトしている場合に明示的に開くには --open-browser を使用します。CI、コンテナー、SSH、ヘッドレス環境、および Dashboard アセットがない場合はブラウザーを開きません。完全な手順は Web Dashboard ガイド を参照してください。

Docker / Compose は API Server と Docker README を参照。公式イメージ: oceanbase/powermem-server:latest。

機能概要

メモリパイプラインと検索 — スマート抽出と更新；経験 + スキル 二層蒸留（自己進化）；エビングハウス型減衰；ハイブリッド検索（ベクトル / 全文 / グラフ）；サブストアとルーティング。

プロフィールとマルチエージェント — ユーザープロフィール；共有 / 分離メモリとスコープ。

マルチモーダル — テキスト / 画像 / 音声。

Provider 一覧

レイヤー標準搭載の Provider
LLMAnthropic、OpenAI、Azure OpenAI、Gemini、Qwen（+ ASR）、DeepSeek、Ollama、vLLM、SiliconFlow、Z.AI、LangChain ラッパー
EmbeddingOpenAI、Azure OpenAI、Qwen（+ VL マルチモーダル、スパース）、Gemini、Vertex AI、AWS Bedrock、Ollama、LM Studio、HuggingFace、Together、SiliconFlow、Z.AI、OceanBase MASS、LangChain ラッパー
RerankJina、Qwen、Z.AI、汎用
StorageOceanBase（+ グラフ）、埋め込み seekdb、PostgreSQL/pgvector、SQLite

ドキュメント

  • はじめに — インストール、.env、最初の Memory 利用
  • 設定 — 設定モデル、ストレージバックエンド、環境変数
  • Web Dashboard — メモリ検査、分析、システム監視のためのビジュアルインターフェース
  • アーキテクチャ — 主要コンポーネント、ストレージ構成、検索の流れ
  • API とサービス — REST、MCP、HTTP サーバー、Python 向け API
  • CLI — pmem コマンド、対話シェル、バックアップとマイグレーション
  • マルチエージェント — スコープ、分離、エージェント間共有
  • 連携 — LangChain などフレームワーク連携
  • エコシステム連携 — AI クライアントと IDE（Claude Code など）
  • Docker とデプロイ — イメージ、Compose、API サーバーの実行
  • 開発 — ローカル環境、テスト、コントリビューション

その他: サブストア、ガイド一覧。

サンプル

  • シナリオと Notebook — ユースケース別の手順（基本利用、マルチモーダル、忘却曲線、スパースベクトル、サブストアなど）
  • クライアント / IDE 側の入口（OpenClaw、Claude Code、VS Code 拡張、MCP、LangChain、LangGraph）は上記 連携 を参照。

リリースハイライト

バージョン日付内容
1.2.02026-04経験 + スキル 二層蒸留と distill_all()（自己進化型メモリ、AppWorld +15 pts）；OB MASS Embedding；Qwen VL マルチモーダル Embedding；OceanBase Zero Mode 互換；LOCOMO 精度を 87.79% に引き上げ
1.1.02026-04-02OceanBase 向けに埋め込み seekdb（別途 DB サービス不要）；IDE 連携（VS Code 拡張、Claude Code プラグイン）
1.0.02026-03-16CLI（pmem）：メモリ操作、設定、バックアップ/復元/マイグレーション、対話シェル、補完；Web Dashboard
0.5.02026-02-06SDK/API 設定の統一（pydantic-settings）；OceanBase native hybrid search；メモリクエリと一覧ソート；プロフィールの言語カスタマイズ
0.4.02026-01-20スパースベクトル混合検索；プロフィール起点のクエリ書き換え；スキーマ更新と移行ツール
0.3.02026-01-09本番向け HTTP API Server；Docker
0.2.02025-12-16プロフィール強化；マルチモーダル（テキスト/画像/音声）
0.1.02025-11-14コアメモリとハイブリッド検索；LLM 抽出；忘却曲線；マルチエージェント；OceanBase/PostgreSQL/SQLite；グラフ検索

サポート

ライセンス

Apache License 2.0 — 詳細は LICENSE。