Metadata-Version: 2.5
Name: classive-sdk
Version: 0.1.2
Summary: Official synchronous and asynchronous Python SDK for the Classive educational content API
Project-URL: Homepage, https://classive.app
Project-URL: Documentation, https://github.com/classive-hq/sdk/blob/main/python/README.md
Project-URL: Repository, https://github.com/classive-hq/sdk
Project-URL: Issues, https://github.com/classive-hq/sdk/issues
Project-URL: Changelog, https://github.com/classive-hq/sdk/blob/main/python/CHANGELOG.md
Author: Classive Ltd
License-Expression: MIT
License-File: LICENSE
Keywords: api-client,classive,course-generation,edtech,education,lesson-generation,sdk
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Education
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: httpx<1,>=0.27
Description-Content-Type: text/markdown

# Classive Python SDK

Synchronous and native asynchronous clients for the Classive Results API, on Python 3.11+.

```sh
python -m pip install classive-sdk
```

```python
from classive import Classive

with Classive() as client:  # reads CLASSIVE_API_KEY from your server environment
    print(client.voices.list())
    print(client.billing.credits())
```

Use `AsyncClassive` with `async with` and `await` for asynchronous applications. All public API operations have typed resource methods; JSON dictionaries use the API's camelCase field names, and methods/options use snake_case.

```python
import asyncio
from classive import AsyncClassive

async def main():
    async with AsyncClassive() as client:
        print((await client.voices.list())["data"])

asyncio.run(main())
```

See the [full SDK guide](https://github.com/classive-hq/sdk#python), [workflow examples](https://github.com/classive-hq/sdk/blob/main/docs/workflows.md), and [API reference](https://classive.app/api).

Generation is chargeable: request a quote, check it against your spending policy, then submit its `quoteId`. Mutations never retry automatically. Polling does not implicitly cancel server work. Keep API keys on your server.

Looking for JavaScript or TypeScript? See the [JavaScript SDK](https://github.com/classive-hq/sdk/blob/main/javascript/README.md).
