quis-sdk 0.1.0

Official Python SDK for the Quis Memory API

quis-sdk

Official Python SDK for the Quis Memory API — a human-centric, affect-aware memory layer for LLM agents.

Installation

pip install quis-sdk

Quickstart

import asyncio
from quis_sdk import Quis

async def main():
    async with Quis(api_key="quis_sk_...") as q:

        # Ingest a conversation message
        await q.ingest(
            messages=[
                {
                    "message_id": "msg-001",
                    "sender_id": "user-uuid",
                    "timestamp": "2026-03-15T10:00:00Z",
                    "text": "I just visited Paris for the first time!",
                    "user_name": "Alice",
                }
            ],
            conversation_id="conv-123",
        )

        # Retrieve memories when answering a question
        result = await q.retrieve(
            user_id="user-uuid",
            question="Where has this user traveled?",
        )

        # Inject the memory context into your LLM system prompt
        print(result["prompt"])

asyncio.run(main())

Configuration

Parameter	Description	Default
api_key	Your Quis API key (starts with quis_sk_)	required
base_url	API base URL (override for self-hosted)	https://api.quis.ai
timeout	Request timeout in seconds	60

Get your API key at app.quis.ai.

Error Handling

from quis_sdk import Quis, QuisAuthError, QuisRateLimitError, QuisAPIError

async with Quis(api_key="quis_sk_...") as q:
    try:
        result = await q.retrieve(user_id="u1", question="What do I like?")
    except QuisAuthError:
        print("Invalid API key")
    except QuisRateLimitError as e:
        print(f"Rate limited. Retry after {e.retry_after}s")
    except QuisAPIError as e:
        print(f"Server error {e.status_code}: {e.detail}")

Self-hosted Deployments

Point the SDK at your own instance:

q = Quis(api_key="quis_sk_...", base_url="https://memory.your-company.com")

License

MIT — see LICENSE.