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

# Installation

> pip install kataven, set two env vars, you're done.

```bash theme={null}
pip install kataven
```

Requires Python 3.10+. Single dependency: `requests`.

## Configure

```bash theme={null}
export KATAVEN_API_KEY="eyJhbGciOi..."   # bearer token
export KATAVEN_ACCOUNT_ID="acme"         # account slug
```

Or pass explicitly:

```python theme={null}
client = KatavenClient(
    api_key="eyJhbGciOi...",
    account_id="acme",
    base_url="https://api.kataven.ai/hub-api",  # optional
    timeout=30,
)
```

## Verify

```python theme={null}
from kataven import KatavenClient
client = KatavenClient()
print(client.agents.list())
```

If that returns a list (even an empty one), you're set up.

## Need an unreleased build?

If you need a feature that's landed in the source but isn't yet on PyPI, email [support@kataven.ai](mailto:support@kataven.ai) and we'll cut a pre-release wheel for you. The SDK source repo is private to Kataven today.
