Metadata-Version: 2.4
Name: alectocore-sdk
Version: 0.1.1
Summary: Official Python SDK for Alecto Core
Author-email: StrathWorks Ltd <support@alectocore.com>
License-Expression: MIT
Project-URL: Homepage, https://alectocore.com/sdk
Project-URL: Documentation, https://alectocore.com/sdk
Project-URL: Repository, https://github.com/StrathWorks/AlectoCore-python
Project-URL: Bug Tracker, https://github.com/StrathWorks/AlectoCore-python/issues
Keywords: alectocore,moderation,content-moderation,trust-and-safety,api-client
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
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 :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# alectocore-sdk

Official Python SDK for Alecto Core.

## Requirements
- Python 3.9+
- Alecto Core key

## Install
```bash
pip install alectocore-sdk
```

## Quickstart
```python
from alectocore_sdk import AlectoCoreClient

client = AlectoCoreClient(api_key="ak_live_xxx")
out = client.moderate({"text": "you are an idiot"})
print(out["request_id"], out["action"], out["score"])
```

## Supported methods
- `moderate(body)`
- `moderate_handle(body)`
- `moderate_batch(body)`
- `moderate_structured(body)`
- `categories()`
- `feedback(body)`
- `queue(limit=100)`
- `resolve_queue_item(request_id, body)`

## Errors
API errors raise `AlectoCoreError` with:
- `status` HTTP status
- `data` parsed error response (if available)

## Base URL override
```python
client = AlectoCoreClient(
    api_key="ak_live_xxx",
    base_url="http://localhost:8080"
)
```
