Skip to content

Installation

import { Aside } from ‘@astrojs/starlight/components’;

mempill 0.2.0 is published on crates.io.

SQLite topology-a (embedded, single-agent)

Section titled “SQLite topology-a (embedded, single-agent)”

The mempill facade crate re-exports mempill-core and mempill-sqlite for the most common embedded case:

Cargo.toml
[dependencies]
mempill = "0.2"
tokio = { version = "1", features = ["full"] }

Or add individual crates:

Terminal window
cargo add mempill

PostgreSQL topology-b (multi-agent shared database)

Section titled “PostgreSQL topology-b (multi-agent shared database)”
Cargo.toml
[dependencies]
mempill-postgres = "0.2"
mempill-core = "0.2"
tokio = { version = "1", features = ["full"] }

Or with cargo-add:

Terminal window
cargo add mempill-postgres mempill-core
  • Rust 1.88 or later (MSRV, edition 2021)
  • Tokio async runtime
  • For PostgreSQL topology-b: a running PostgreSQL 16+ instance

The Python wheel mempill is published on PyPI and requires Python 3.11 or later.

Terminal window
pip install mempill

mempill-mcp is not on PyPI. Install it from source into the same virtual environment as the wheel:

Terminal window
cd mempill/mempill-mcp
pip install .

Run the MCP server:

Terminal window
export MEMPILL_AGENT_ID="my-agent"
export MEMPILL_DB_PATH="/path/to/agent.db" # omit for in-memory (ephemeral)
mempill-mcp
Terminal window
cargo check
import mempill
engine = mempill.open_in_memory()
print("mempill ready:", engine)
# mempill ready: <builtins.PyEngine object at 0x...>