mymemo

Python SDK for MyMemo — HTTP client for the MyMemo memory ledger.

Install

pip install mymemo

Quick Start

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

# Configure — point to running MyMemo server
config = MyMemoConfig(
    server_url="http://localhost:3000",
)

# Connect
clients = create_clients(config)
store = MemoryStore(clients, 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

• HTTP client — calls the TypeScript core API, no direct database access
• Idempotent writes — server-side SHA256 deterministic IDs
• Hybrid search — FTS5 full-text + vector similarity via server
• Adaptive ranking — server-side time decay, category-specific tuning
• GC — server-side automatic eviction of stale memories

License

MIT