Quickstart

1. Install Agentic Memory

The recommended way to install is with pipx or uv:

pipx install agentic-memory

Or with uv:

uv tool install agentic-memory

2. Start Neo4j

Agentic Memory uses Neo4j as its graph database. The easiest way to run it locally is with Docker:

docker compose up -d neo4j

Neo4j will be available at bolt://localhost:7687 with user neo4j and password password.

3. Initialize in your project

Run the interactive wizard in your project directory:

cd /path/to/your/project agentic-memory init

The wizard will guide you through Neo4j setup, embedding provider selection (Gemini by default), and file extensions to index.

4. Index your codebase

Run a one-time structural ingestion:

agentic-memory index

5. Start the MCP server

Start the MCP server so your AI agent can access memory tools:

agentic-memory serve

Then configure your AI client (Claude, Cursor, etc.) to connect. See the MCP Integration guide for details.