Metadata-Version: 2.4
Name: labelty-sdk
Version: 1.0.0
Summary: Official Python client for the Labelty API.
Author: Labelty
License-Expression: MIT
Project-URL: Homepage, https://labelty.ai
Project-URL: Documentation, https://docs.labelty.ai/guides/sdk/overview/
Keywords: labelty,annotation,labeling,api,sdk,ml,computer-vision
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx>=0.26.0
Provides-Extra: dev
Requires-Dist: pytest>=7.4.4; extra == "dev"
Requires-Dist: build>=1.2.0; extra == "dev"
Requires-Dist: twine>=5.0.0; extra == "dev"
Dynamic: license-file

# Labelty Python SDK

Official Python client for the [Labelty](https://labelty.ai) API.

The Labelty SDK allows developers and ML engineers to integrate Labelty into their Python workflows.
Use it to manage annotation projects, assets, label schemas, models, and predictions programmatically.

## Requirements

- Python 3.10 or higher
- A Labelty API key

## Install

```bash
pip install labelty-sdk
```

## Quick start

1. In the Labelty app, open your project → **API Key** → create a key (`lty_…`).
2. Connect:

```python
import os
from labelty_sdk import LabeltyClient

with LabeltyClient(api_key=os.environ["LABELTY_API_KEY"]) as client:
    project = client.project
    print(f"Connected to: {project.name}")
```

## What you can do

| Area | Examples |
| ---- | -------- |
| Project | `client.project` |
| Label schema | `project.schema.get()`, `project.schema.create(...)` |
| Assets | `project.assets.list(...)`, download one or many |
| Models | create, upload, activate, publish |
| Predictions | `project.predictions.create_batch(...)` |
| Org / marketplace | `client.org_models`, `client.marketplace` |

## Error handling

```python
from labelty_sdk.exceptions import LabeltyHTTPError

try:
    project = client.projects.get("bad-id")
except LabeltyHTTPError as e:
    print(e.status_code, e.payload)
```

## Documentation

Full guides: [docs.labelty.ai — Python SDK](https://docs.labelty.ai/guides/sdk/overview/)

- [Install and connect](https://docs.labelty.ai/guides/sdk/install-and-connect/)
- [Assets](https://docs.labelty.ai/guides/sdk/assets/)
- [Models](https://docs.labelty.ai/guides/sdk/models/)
- [Predictions](https://docs.labelty.ai/guides/sdk/predictions/)

## License

MIT
