mindmemos-sdk

Python SDK and CLI for MindMemOS, a long-term memory system for AI agents and applications.

Install

pip install mindmemos-sdk

The package also installs the mindmemos command.

Configure

mindmemos auth

You can also pass base_url, api_key, and user_id directly when creating a client. The default user_id is used by operations that require a user, such as memory.add. Search is different: memory.search only uses the user_id passed to that call. Omit it for a project-wide search, or pass it explicitly for a user-scoped search.

Python SDK

from mindmemos_sdk import DialogueMessage, MindMemOSClient

with MindMemOSClient(user_id="alice", app_id="my-agent") as client:
    client.memory.add(
        messages=[
            DialogueMessage(role="user", content="I prefer iced Americano."),
        ],
    )

    result = client.memory.search(
        "What coffee does the user prefer?", top_k=5, user_id="alice", token_budget=2000
    )
    for memory in result.memories:
        print(memory.memory)

CLI

mindmemos memory add --content "I prefer iced Americano" --user-id alice
mindmemos memory search "coffee preference" --top-k 5 --user-id alice --token-budget 2000