FAQ

pip install maximem-synap

import asyncio
from maximem_synap import MaximemSynapSDK

async def ingest():
    sdk = MaximemSynapSDK(api_key="synap_your_key_here")
    await sdk.initialize()
    return await sdk.memories.create(
        document="User prefers dark mode.",
        document_type="ai-chat-conversation",
        user_id="user_123",
        customer_id="acme_corp",
        mode="fast",
    )

# From synchronous code
result = asyncio.run(ingest())

import uuid
from maximem_synap import (
    AuthenticationError,       # raised when the API key is missing, malformed, or revoked
    ContextNotFoundError,      # raised when the conversation is unknown
    RateLimitError,            # raised after the SDK exhausts its automatic retries on rate-limited calls
    ServiceUnavailableError,   # raised when Synap is temporarily unavailable
    InvalidInputError,         # raised when the arguments to an SDK call are invalid
)

try:
    context = await sdk.conversation.context.fetch(
        conversation_id=str(uuid.uuid4()),
        search_query=["user preferences"],
    )
except RateLimitError as e:
    # Automatic retry with backoff is built into the SDK.
    # This exception is raised only after all retries are exhausted.
    print(f"Retry after {e.retry_after}s")
except ContextNotFoundError:
    print("Conversation not found")

await sdk.memories.delete("mem_a1b2c3d4e5f67890")