Metadata-Version: 2.4
Name: ucotron-sdk
Version: 1.0.0
Summary: Official Ucotron API client SDK for Python — auto-generated from OpenAPI.
Project-URL: Homepage, https://docs.ucotron.com/sdks/python
Project-URL: Documentation, https://docs.ucotron.com/sdks/python
Project-URL: Repository, https://github.com/Ucotron/ucotron-sdks
Project-URL: Issues, https://github.com/Ucotron/ucotron-sdks/issues
Author-email: Ucotron Engineering <engineering@ucotron.com>
License: Apache-2.0
Keywords: actuarial,agronomic,ai,insurance,openapi,sdk,ucotron
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Requires-Dist: httpx>=0.27.0
Provides-Extra: dev
Requires-Dist: mypy>=1.10; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.4; extra == 'dev'
Description-Content-Type: text/markdown

# ucotron-sdk

Official Python 3.9+ client for the [Ucotron Core API](https://gateway.core.ucotron.com).

> Full quickstart, 5 use-case walkthroughs, and reference docs:
> **<https://docs.ucotron.com/sdks/python>**

## Install

```bash
pip install ucotron-sdk
# or
uv add ucotron-sdk
```

## Usage

```python
import os
from ucotron_sdk import UcotronClient

ucotron = UcotronClient(api_key=os.environ["UCOTRON_API_KEY"])

# List plans
plans = ucotron.plans.list(limit=20)

# Generate a plan
plan = ucotron.plans.generate(interaction_id="int_123")

# Verify an incoming webhook signature
ok = UcotronClient.verify_webhook_signature(
    body=raw_body,                                     # bytes
    signature=request.headers["X-Ucotron-Signature"],  # str
    secret=os.environ["WEBHOOK_SECRET"],
)
```

## Versioning

This package follows the API revision in `openapi.yaml` (`info.version`).
A minor API bump triggers a minor SDK bump. PEP-440 pre-release tags
(`1.0.0a0`) map to the semver alpha tags.

## License

[Apache-2.0](../../LICENSE).
