Skip to main content

​
Installation

Install the SDK via Poetry or pip: 
poetry add recallrai

​
Initialize Client

Create a client instance with your API key and project ID: 
from recallrai import RecallrAI

client = RecallrAI(
    api_key="rai_yourapikey",
    project_id="project-uuid",
    base_url="https://api.recallrai.com",  # optional: custom endpoint
    timeout=60,  # optional: timeout in seconds (default: 60)
)
All datetime objects returned by the SDK are in UTC timezone.

​
Parameters

​
api_key
string
required
Your RecallrAI API key. Must start with rai_.
​
project_id
string
required
Your project UUID from the RecallrAI dashboard.
​
base_url
string
Custom API endpoint. Default: https://api.recallrai.com
​
timeout
integer
Request timeout in seconds. Default: 60

​
Async Support

The SDK provides full async/await support for all operations. Use AsyncRecallrAI, AsyncUser, and AsyncSession for async applications: 
from recallrai import AsyncRecallrAI

client = AsyncRecallrAI(
    api_key="rai_yourapikey",
    project_id="project-uuid"
)

# All usage patterns are identical, just with await keywords
user = await client.create_user(user_id="user123")
All async classes have the same API as their sync counterparts - just add await before method calls.
When user and session IDs are already trusted in your system, you can skip SDK lookup calls by setting validate=False on get_user() and get_session().