Metadata-Version: 2.4
Name: actorhub
Version: 0.2.0
Summary: Official Python SDK for ActorHub.ai - Verify AI-generated content against protected identities
Project-URL: Homepage, https://actorhub.ai
Project-URL: Documentation, https://actorhub.ai/developers
Project-URL: Repository, https://github.com/actorhubai/actorhub-python
Project-URL: Issues, https://github.com/actorhubai/actorhub-python/issues
Author-email: "ActorHub.ai" <admin@actorhub.ai>
License-Expression: MIT
License-File: LICENSE
Keywords: actorhub,ai,c2pa,consent,deepfake,face-recognition,identity
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Security
Requires-Python: >=3.8
Requires-Dist: httpx>=0.24.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: tenacity>=8.0.0
Description-Content-Type: text/markdown

# ActorHub Python SDK

Official Python SDK for [ActorHub.ai](https://actorhub.ai) — Verify AI-generated content against protected identities.

## Installation

```bash
pip install actorhub
```

## Quick Start

```python
from actorhub import ActorHub

client = ActorHub(api_key="your-api-key")

# Check consent before AI generation
result = client.check_consent(
    platform="sora",
    intended_use="video",
    image_url="https://example.com/face.jpg",
)

if result.protected:
    face = result.faces[0]
    print(f"Protected: {face.display_name}")
    print(f"Consent: {face.consent.video_generation}")
    
    # Check if active consent token exists
    if face.token and face.token.valid:
        print(f"Active token: {face.token.source}")
    
    # Verify trust signature
    if result.trust:
        print(f"Signed: {result.trust.algorithm}")
```

## With Consent Token

```python
result = client.check_consent(
    platform="sora",
    intended_use="video",
    image_url="https://example.com/face.jpg",
    consent_token="ACT-XXXX",  # Token from identity owner
)
```

## Async Support

```python
from actorhub import AsyncActorHub

async with AsyncActorHub(api_key="your-api-key") as client:
    result = await client.check_consent(
        platform="runway",
        intended_use="video",
        image_url="https://example.com/face.jpg",
    )
```

## Links

- [Documentation](https://actorhub.ai/developers)
- [API Reference](https://api.actorhub.ai/docs)
- [Website](https://actorhub.ai)
