Installation

Install CMK and run setup. Two commands to get started.

Install

pip install claude-memory-kit

Requires Python 3.10+. Works on macOS, Linux, and Windows (WSL recommended).

Setup

Run setup to connect your account and auto-configure Claude. This handles MCP configuration, API key setup, and client detection.

cmk setup

Cloud mode is the default. We handle the vector database and embeddings. You just need your CMK account.

Alternative install methods

uv (faster installs)

uv pip install claude-memory-kit

From source

git clone https://github.com/thierrydamiba/claude-memory.git
cd claude-memory
uv pip install -e .

Verify installation

cmk --version

Local mode (advanced)

Skip cloud setup entirely. Local mode uses SQLite for storage and fastembed for vectors. Everything runs on your machine with zero network calls. No account needed.

cmk init
cmk serve --port 7749

You will need to manually add the MCP config to your Claude client. See the MCP configuration docs.