Mnemoverse Python SDK

Persistent memory for AI agents. Not vector search — statistical learning.

Installation

pip install mnemoverse

Quick Start

from mnemoverse import MnemoClient

client = MnemoClient(api_key="mk_live_YOUR_KEY")

# Store a memory
result = client.write(
    "Retry with exponential backoff fixed the timeout issue",
    concepts=["retry", "backoff", "timeout"]
)

# Query — Hebbian associations expand "timeout" → "retry", "backoff"
memories = client.read("how to handle timeouts?")

# Report outcome — the system learns what works
client.feedback(
    atom_ids=[item.atom_id for item in memories.items],
    outcome=1.0,
    query_concepts=memories.query_concepts
)

Async Client

from mnemoverse import AsyncMnemoClient

async with AsyncMnemoClient(api_key="mk_live_YOUR_KEY") as client:
    result = await client.write("async memory", concepts=["async"])
    memories = await client.read("what about async?")

Features

Circuit breaker — 5 failures → open → 30s half-open → probe
Retry with backoff — 3 attempts, rate-limit-aware
Sync + async — MnemoClient for scripts, AsyncMnemoClient for FastAPI
Type-safe — Pydantic models, full type hints

Methods

Method	Description
`write(content, concepts, domain, metadata)`	Store a memory
`write_batch(items)`	Store up to 500 memories
`read(query, top_k, domain)`	Query with Hebbian expansion
`feedback(atom_ids, outcome)`	Report success/failure
`stats()`	Memory statistics
`health()`	API health check

Documentation

License

MIT

Metadata

Release files for mnemoverse 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mnemoverse 0.1.0
File	Size	Uploaded
mnemoverse-0.1.0.tar.gz	7.6 kB	Apr 9, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for mnemoverse 0.1.0
File	Interpreter	ABI	Platform	Reset
mnemoverse-0.1.0-py3-none-any.whl 9.3 kB Apr 9, 2026	Python 3	none	any	Details

Total release size: 16.9 kB

Release files / mnemoverse-0.1.0.tar.gz

Download URL	mnemoverse-0.1.0.tar.gz
Size	7.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`1ba99be9e4d3c4874d8950ecaf8c0d11e1b4706326201f5e8bc0912404616d21`
BLAKE2b-256 checksum How to use checksums	`b131e3ed2dbdb9626b0e6cb9723f58e9b43e389fda56df979d8294974c3790f5`
Upload date	Apr 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.14.2`

Release files / mnemoverse-0.1.0-py3-none-any.whl

Download URL	mnemoverse-0.1.0-py3-none-any.whl
Size	9.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`840f671a928f7979653d17c11868ed74c079e6b27d800bcc5bc435c668e417cd`
BLAKE2b-256 checksum How to use checksums	`06cf274181c2a564bc3087594c085b464e768a85b90a5e9ba9fe3d421877b829`
Upload date	Apr 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.14.2`