ctxvault

Python SDK for CtxVault — Persistent Memory for AI.

Install

pip install ctxvault

Usage

from ctxvault import CtxVault

vault = CtxVault(
    api_key="cv_your_key",
    project="your-project",
    base_url="https://ctxvault.dev",
)

# Store a memory
vault.remember(
    type="decision",
    title="Use PostgreSQL for persistence",
    content="Chose PostgreSQL with pgvector for vector search support.",
    tags=["database", "architecture"],
)

# Search memories
results = vault.recall("database decisions")

# Get context pack
pack = vault.context_pack("project architecture")
print(pack["pack"])

# List all memories
items = vault.list(status="verified")

API

CtxVault(api_key, project, base_url=None)

vault.remember(type, title, content, importance=5, tags=None) — Store a memory

vault.recall(query, k=5) — Search memories

vault.context_pack(query, max_tokens=2000) — Generate context pack

vault.list(status=None, type=None) — List memory items

vault.verify(id) — Verify a candidate

vault.pin(id) — Pin a verified item

vault.deprecate(id, reason) — Deprecate an item

License

MIT