actorhub 0.1.0__tar.gz

actorhub-0.1.0/.gitignore

@@ -0,0 +1,93 @@
+# Dependencies
+node_modules/
+venv/
+.venv/
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+.Python
+
+# Build outputs
+.next/
+dist/
+build/
+*.egg-info/
+.eggs/
+
+# Environment files
+.env
+.env.local
+.env.*.local
+.env.production
+*.local
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+.DS_Store
+
+# Logs
+logs/
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Testing
+coverage/
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Docker
+docker-compose.override.yml
+
+# Database
+*.db
+*.sqlite
+
+# Uploads (local dev)
+uploads/
+tmp/
+
+# Secrets
+*.pem
+*.key
+credentials.json
+secrets/
+מפתחות.txt
+.claude/settings.local.json
+
+# OS files
+Thumbs.db
+*.DS_Store
+
+# Misc
+*.bak
+*.tmp
+.turbo
+backups/
+nul
+*.sql.gz
+
+# Secret files - never commit
+apps/api/.env.backup
+apps/api/.env.railway
+apps/api/.env.secrets.generated
+env_root_prod.txt
+*.backup
+*.old
+*.orig
+*.save
+
+# SECURITY: Scripts with hardcoded credentials (remove secrets before committing)
+# apps/api/scripts/upload_actors_production.py
+
+# Test files
+login*.json
+register*.json
+test-*.json
+tmpclaude-*

actorhub-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 ActorHub.ai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

actorhub-0.1.0/PKG-INFO

@@ -0,0 +1,237 @@
+Metadata-Version: 2.4
+Name: actorhub
+Version: 0.1.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://docs.actorhub.ai
+Project-URL: Repository, https://github.com/actorhub/actorhub-python
+Project-URL: Issues, https://github.com/actorhub/actorhub-python/issues
+Author-email: "ActorHub.ai" <actorhub.ai@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: actorhub,ai,api,consent,deepfake,face-recognition,identity,verification
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+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 :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: tenacity>=8.0.0
+Provides-Extra: dev
+Requires-Dist: black>=23.0.0; extra == 'dev'
+Requires-Dist: mypy>=1.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: respx>=0.20.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+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
+
+# Initialize the client
+client = ActorHub(api_key="your-api-key")
+
+# Verify if an image contains protected identities
+result = client.verify(image_url="https://example.com/image.jpg")
+
+if result.protected:
+    print(f"Protected identity detected!")
+    for identity in result.identities:
+        print(f"  - {identity.display_name} (similarity: {identity.similarity_score})")
+```
+
+## Features
+
+- **Identity Verification**: Check if images contain protected identities
+- **Consent Checking**: Verify consent before AI generation
+- **Marketplace Access**: Browse and license identities
+- **Actor Pack Training**: Train custom Actor Packs
+- **Async Support**: Full async/await support with `AsyncActorHub`
+- **Automatic Retries**: Built-in retry logic with exponential backoff
+- **Type Hints**: Full type annotations for IDE support
+
+## Usage Examples
+
+### Verify Image
+
+```python
+from actorhub import ActorHub
+
+client = ActorHub(api_key="your-api-key")
+
+# From URL
+result = client.verify(image_url="https://example.com/image.jpg")
+
+# From file
+result = client.verify(image_file="/path/to/image.jpg")
+
+# From base64
+result = client.verify(image_base64="base64-encoded-data...")
+
+print(f"Protected: {result.protected}")
+print(f"Faces detected: {result.faces_detected}")
+```
+
+### Check Consent (for AI Platforms)
+
+```python
+result = client.check_consent(
+    image_url="https://example.com/face.jpg",
+    platform="runway",
+    intended_use="video",
+    region="US"
+)
+
+if result.protected:
+    for face in result.faces:
+        print(f"Consent for video: {face.consent.video_generation}")
+        print(f"License available: {face.license.available}")
+```
+
+### Browse Marketplace
+
+```python
+# Search listings
+listings = client.list_marketplace(
+    query="actor",
+    category="ACTOR",
+    sort_by="popular",
+    limit=10
+)
+
+for listing in listings:
+    print(f"{listing.title} - ${listing.base_price_usd}")
+```
+
+### Purchase License
+
+```python
+from actorhub import LicenseType, UsageType
+
+purchase = client.purchase_license(
+    identity_id="uuid-here",
+    license_type=LicenseType.STANDARD,
+    usage_type=UsageType.COMMERCIAL,
+    project_name="My AI Project",
+    project_description="Creating promotional content",
+    duration_days=30,
+)
+
+# Redirect user to Stripe checkout
+print(f"Checkout URL: {purchase.checkout_url}")
+```
+
+### Get My Licenses
+
+```python
+licenses = client.get_my_licenses(status="active")
+
+for lic in licenses:
+    print(f"{lic.identity_name} - {lic.license_type} - Expires: {lic.expires_at}")
+```
+
+## Async Usage
+
+```python
+import asyncio
+from actorhub import AsyncActorHub
+
+async def main():
+    async with AsyncActorHub(api_key="your-api-key") as client:
+        result = await client.verify(image_url="https://example.com/image.jpg")
+        print(f"Protected: {result.protected}")
+
+asyncio.run(main())
+```
+
+## Error Handling
+
+```python
+from actorhub import (
+    ActorHub,
+    AuthenticationError,
+    RateLimitError,
+    ValidationError,
+    NotFoundError,
+)
+
+client = ActorHub(api_key="your-api-key")
+
+try:
+    result = client.verify(image_url="https://example.com/image.jpg")
+except AuthenticationError:
+    print("Invalid API key")
+except RateLimitError as e:
+    print(f"Rate limit exceeded. Retry after: {e.retry_after} seconds")
+except ValidationError as e:
+    print(f"Validation error: {e.message}")
+except NotFoundError:
+    print("Resource not found")
+```
+
+## Configuration
+
+```python
+client = ActorHub(
+    api_key="your-api-key",
+    base_url="https://api.actorhub.ai",  # Custom base URL
+    timeout=30.0,                         # Request timeout in seconds
+    max_retries=3,                        # Max retry attempts
+)
+```
+
+## API Reference
+
+### ActorHub Client
+
+| Method | Description |
+|--------|-------------|
+| `verify()` | Verify if image contains protected identities |
+| `get_identity()` | Get identity details by ID |
+| `check_consent()` | Check consent status for AI generation |
+| `list_marketplace()` | Search marketplace listings |
+| `get_my_licenses()` | Get user's purchased licenses |
+| `purchase_license()` | Purchase a license |
+| `train_actor_pack()` | Initiate Actor Pack training |
+| `get_actor_pack()` | Get Actor Pack status |
+
+## Requirements
+
+- Python 3.8+
+- httpx
+- pydantic
+- tenacity
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Links
+
+- [Documentation](https://docs.actorhub.ai)
+- [API Reference](https://api.actorhub.ai/docs)
+- [GitHub](https://github.com/actorhub/actorhub-python)
+- [PyPI](https://pypi.org/project/actorhub/)

actorhub-0.1.0/README.md

@@ -0,0 +1,199 @@
+# 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
+
+# Initialize the client
+client = ActorHub(api_key="your-api-key")
+
+# Verify if an image contains protected identities
+result = client.verify(image_url="https://example.com/image.jpg")
+
+if result.protected:
+    print(f"Protected identity detected!")
+    for identity in result.identities:
+        print(f"  - {identity.display_name} (similarity: {identity.similarity_score})")
+```
+
+## Features
+
+- **Identity Verification**: Check if images contain protected identities
+- **Consent Checking**: Verify consent before AI generation
+- **Marketplace Access**: Browse and license identities
+- **Actor Pack Training**: Train custom Actor Packs
+- **Async Support**: Full async/await support with `AsyncActorHub`
+- **Automatic Retries**: Built-in retry logic with exponential backoff
+- **Type Hints**: Full type annotations for IDE support
+
+## Usage Examples
+
+### Verify Image
+
+```python
+from actorhub import ActorHub
+
+client = ActorHub(api_key="your-api-key")
+
+# From URL
+result = client.verify(image_url="https://example.com/image.jpg")
+
+# From file
+result = client.verify(image_file="/path/to/image.jpg")
+
+# From base64
+result = client.verify(image_base64="base64-encoded-data...")
+
+print(f"Protected: {result.protected}")
+print(f"Faces detected: {result.faces_detected}")
+```
+
+### Check Consent (for AI Platforms)
+
+```python
+result = client.check_consent(
+    image_url="https://example.com/face.jpg",
+    platform="runway",
+    intended_use="video",
+    region="US"
+)
+
+if result.protected:
+    for face in result.faces:
+        print(f"Consent for video: {face.consent.video_generation}")
+        print(f"License available: {face.license.available}")
+```
+
+### Browse Marketplace
+
+```python
+# Search listings
+listings = client.list_marketplace(
+    query="actor",
+    category="ACTOR",
+    sort_by="popular",
+    limit=10
+)
+
+for listing in listings:
+    print(f"{listing.title} - ${listing.base_price_usd}")
+```
+
+### Purchase License
+
+```python
+from actorhub import LicenseType, UsageType
+
+purchase = client.purchase_license(
+    identity_id="uuid-here",
+    license_type=LicenseType.STANDARD,
+    usage_type=UsageType.COMMERCIAL,
+    project_name="My AI Project",
+    project_description="Creating promotional content",
+    duration_days=30,
+)
+
+# Redirect user to Stripe checkout
+print(f"Checkout URL: {purchase.checkout_url}")
+```
+
+### Get My Licenses
+
+```python
+licenses = client.get_my_licenses(status="active")
+
+for lic in licenses:
+    print(f"{lic.identity_name} - {lic.license_type} - Expires: {lic.expires_at}")
+```
+
+## Async Usage
+
+```python
+import asyncio
+from actorhub import AsyncActorHub
+
+async def main():
+    async with AsyncActorHub(api_key="your-api-key") as client:
+        result = await client.verify(image_url="https://example.com/image.jpg")
+        print(f"Protected: {result.protected}")
+
+asyncio.run(main())
+```
+
+## Error Handling
+
+```python
+from actorhub import (
+    ActorHub,
+    AuthenticationError,
+    RateLimitError,
+    ValidationError,
+    NotFoundError,
+)
+
+client = ActorHub(api_key="your-api-key")
+
+try:
+    result = client.verify(image_url="https://example.com/image.jpg")
+except AuthenticationError:
+    print("Invalid API key")
+except RateLimitError as e:
+    print(f"Rate limit exceeded. Retry after: {e.retry_after} seconds")
+except ValidationError as e:
+    print(f"Validation error: {e.message}")
+except NotFoundError:
+    print("Resource not found")
+```
+
+## Configuration
+
+```python
+client = ActorHub(
+    api_key="your-api-key",
+    base_url="https://api.actorhub.ai",  # Custom base URL
+    timeout=30.0,                         # Request timeout in seconds
+    max_retries=3,                        # Max retry attempts
+)
+```
+
+## API Reference
+
+### ActorHub Client
+
+| Method | Description |
+|--------|-------------|
+| `verify()` | Verify if image contains protected identities |
+| `get_identity()` | Get identity details by ID |
+| `check_consent()` | Check consent status for AI generation |
+| `list_marketplace()` | Search marketplace listings |
+| `get_my_licenses()` | Get user's purchased licenses |
+| `purchase_license()` | Purchase a license |
+| `train_actor_pack()` | Initiate Actor Pack training |
+| `get_actor_pack()` | Get Actor Pack status |
+
+## Requirements
+
+- Python 3.8+
+- httpx
+- pydantic
+- tenacity
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Links
+
+- [Documentation](https://docs.actorhub.ai)
+- [API Reference](https://api.actorhub.ai/docs)
+- [GitHub](https://github.com/actorhub/actorhub-python)
+- [PyPI](https://pypi.org/project/actorhub/)

actorhub-0.1.0/actorhub/__init__.py

@@ -0,0 +1,57 @@
+"""
+ActorHub.ai Python SDK
+
+Official Python client for the ActorHub.ai API.
+Verify AI-generated content against protected identities.
+"""
+
+from .client import ActorHub, AsyncActorHub
+from .models import (
+    VerifyResponse,
+    VerifyResult,
+    IdentityResponse,
+    ConsentCheckResponse,
+    ConsentResult,
+    MarketplaceListingResponse,
+    LicenseResponse,
+    ActorPackResponse,
+    TrainingStatus,
+    ProtectionLevel,
+    LicenseType,
+    UsageType,
+)
+from .exceptions import (
+    ActorHubError,
+    AuthenticationError,
+    RateLimitError,
+    ValidationError,
+    NotFoundError,
+    ServerError,
+)
+
+__version__ = "0.1.0"
+__all__ = [
+    # Clients
+    "ActorHub",
+    "AsyncActorHub",
+    # Models
+    "VerifyResponse",
+    "VerifyResult",
+    "IdentityResponse",
+    "ConsentCheckResponse",
+    "ConsentResult",
+    "MarketplaceListingResponse",
+    "LicenseResponse",
+    "ActorPackResponse",
+    "TrainingStatus",
+    "ProtectionLevel",
+    "LicenseType",
+    "UsageType",
+    # Exceptions
+    "ActorHubError",
+    "AuthenticationError",
+    "RateLimitError",
+    "ValidationError",
+    "NotFoundError",
+    "ServerError",
+]