当前为常用粗语程器：PowerMem

Install

```bash

With HTTP API server only (powermem-server; does not install seekdb)

pip install "powermem[server]"

With MCP server only (powermem-mcp; does not install seekdb)

pip install "powermem[mcp]"

Common full local install

pip install "powermem[cli,server,mcp,seekdb]"

For zero-install MCP clients such as Cursor, Codex, Claude Desktop, Cline, or
Goose, use the wrapper package:

The `powermem-mcp` wrapper is version-locked to the main `powermem` release and
installs `powermem[mcp,seekdb]` for the same version. If `uv` has cached an older
tool environment, refresh it explicitly:

Quick start (Python SDK)

Prerequisites: Copy .env.example to .env and set your LLM API key — that is the only required credential. For zero-config local storage, install the seekdb extra (pip install "powermem[seekdb]", or combine it with server / mcp) so the default OceanBase provider can boot embedded seekdb on disk. Without seekdb, set OCEANBASE_HOST to point at a remote OceanBase cluster, or switch to sqlite / postgres. The default embedder is a local all-MiniLM-L6-v2 model (384 dims) that needs no API key and auto-downloads on first use. Need to tune providers or unlock advanced features? Copy .env.example.full instead — it documents every available knob, grouped by component. After install, pmem config init walks you through the same setup interactively. See Getting started.

Examples

• Scenarios & notebooks — walkthroughs by use case (basic usage, multimodal, forgetting curve, sparse vectors, sub stores, and more)
• See Integrations above for client-side and IDE-side entry points (OpenClaw, Claude Code, VS Code extension, MCP, LangChain, LangGraph).

Core only (SDK; no optional CLI/server/MCP/seekdb)

pip install powermem

With seekdb for zero-config local storage/embedder

pip install "powermem[seekdb]"

SDKs & apps

SDKs

---

With CLI (pmem / powermem-cli)

pip install "powermem[cli]"

HTTP API server + seekdb

pip install "powermem[server,seekdb]"

SDK

Run from a directory that contains your configured .env:

from powermem import Memory, auto_config

memory = Memory(config=auto_config())

memory.add("User likes coffee", user_id="user123")

for r in memory.search("user preferences", user_id="user123").get("results", []):
    print("-", r.get("memory"))

More patterns: Getting Started.

CLI (`pmem`, 1.0+)

pmem memory add "User prefers dark mode" --user-id user123
pmem memory search "preferences" --user-id user123
pmem shell                           # interactive REPL

Full reference: CLI usage.

HTTP API server + Dashboard

Uses the same .env as the SDK. Dashboard is served under /dashboard/.

powermem-server --host 0.0.0.0 --port 8848

On an interactive local terminal, the server automatically opens the Dashboard in your default browser once it is ready. You can also open http://localhost:8848/dashboard/ manually to browse memories, view analytics, and monitor system health. Use --no-open-browser to disable auto-open, or --open-browser when output is redirected. Browser opening is skipped in CI, containers, SSH sessions, headless environments, and when Dashboard assets are unavailable. See the Web Dashboard Guide for a complete walkthrough.

Docker / Compose: see API Server and Docker & deployment. The official image is oceanbase/powermem-server:latest.

---

Integrations — pick your client, copy one line

PowerMem ships first-party plugins and setup guides for the most common AI clients. All of them point at the same backend (HTTP server, MCP server, or local pmem CLI) — no per-client schema rewrites. All agents share the same memory server.

Cursor, VS Code, Windsurf, GitHub Copilot, Qoder

Recommended setup — let your IDE agent set it up

First download the code and enter the directory:

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

Then open the AI agent window in your IDE and paste this one line:

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

The agent follows apps/vscode-extension/SETUP.md: it prefers a reusable powermem-server HTTP API backend, falls back to MCP-only only when HTTP is unavailable, and configures the current IDE/client instead of unrelated tools.

Manual setup

Prefer to wire it by hand? Use the per-IDE guide:

The same extension also provides Query memories, Add selection to memory, Quick note, and a status-bar Dashboard. See apps/vscode-extension/README.md and the full VS Code guide.