Quickstart

pip install mneno

from mneno import MemoryClient

# Initialize the client (defaults to in-memory storage)
client = MemoryClient()

# Add memories
client.add(
    "The user is building Mneno, a Python SDK for explainable AI memory.",
    memory_type="semantic",
    importance=0.9,
    tags=["project", "mneno"],
)

client.add(
    "User prefers lightweight Python-first SDKs.",
    memory_type="preference",
    importance=0.85,
)

# Search memories
results = client.search("What is the user building?")

for result in results:
    print(f"Content: {result.memory.content}")
    print(f"Score: {result.score.total}")
    print(f"Reasons: {result.score.reasons}")

# Build a context package with a 50-token budget
context = client.build_context("What is the user building?", budget=50)

print(context.text)

# See why items were included
for item in context.included:
    print(f"Included: {item.memory_id} (Reason: {item.reason})")

traced_client = MemoryClient(trace_enabled=True)
traced_client.add("The user is building Mneno.", importance=0.9)

traced_client.search("What is the user building?")
trace = traced_client.get_trace(traced_client.last_trace_id or "")

if trace is not None:
    for event in trace.events:
        print(event.event_type, event.message)

result = traced_client.evaluate_context("What is the user building?", budget=1200)

for metric in result.metrics:
    print(metric.name, metric.value, metric.unit)