> ## Documentation Index
> Fetch the complete documentation index at: https://docs.recallrai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Get started with the RecallrAI Python SDK in minutes

## Installation

Install the SDK via Poetry or pip:

<CodeGroup>
  ```bash Poetry theme={null}
  poetry add recallrai
  ```

  ```bash pip theme={null}
  pip install recallrai
  ```
</CodeGroup>

## Initialize Client

Create a client instance with your API key and project ID:

```python theme={null}
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)
)
```

<Note>
  All datetime objects returned by the SDK are in UTC timezone.
</Note>

## Parameters

<ParamField path="api_key" type="string" required>
  Your RecallrAI API key. Must start with `rai_`.
</ParamField>

<ParamField path="project_id" type="string" required>
  Your project UUID from the RecallrAI dashboard.
</ParamField>

<ParamField path="base_url" type="string">
  Custom API endpoint. Default: `https://api.recallrai.com`
</ParamField>

<ParamField path="timeout" type="integer">
  Request timeout in seconds. Default: `60`
</ParamField>

## Async Support

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

```python theme={null}
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")
```

<Tip>
  All async classes have the same API as their sync counterparts - just add `await` before method calls.
</Tip>

<Tip>
  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()`.
</Tip>