mymemo 0.1.2

Python SDK for MyMemo — Agent memory ledger on Turso/libSQL

mymemo

Python SDK for MyMemo — Agent memory ledger on Turso/libSQL.

Install

pip install mymemo

Quick Start

from mymemo import MyMemoConfig, create_clients, MemoryStore, rank
from mymemo.types import MemoryFactDraft, IncidentBase, SearchQuery
import time

# Configure
config = MyMemoConfig(
    routing={"primary": "wss://your-db.turso.io", "replica": "file:./local.db"}
)

# Connect
clients = create_clients(config)
store = MemoryStore(clients.writer, dimension=384)

# Write memory
meta = IncidentBase(scope="my-agent", incident_id="1", timestamp=int(time.time()))
store.write(MemoryFactDraft(content="User prefers dark mode", category="user_preference"), meta)

# Search
results = store.get_candidates(SearchQuery(scope="my-agent", keyword="dark"))
ranked = rank(results, SearchQuery(scope="my-agent"))

Features

• Idempotent writes — SHA256 deterministic IDs, no duplicates
• Hybrid search — FTS5 full-text + vector similarity
• Adaptive ranking — time decay, category-specific tuning
• GC — automatic eviction of stale memories
• NaN defense — rejects invalid vectors at write time
• Shared database — compatible with the TypeScript core SDK

License

MIT