Metadata-Version: 2.4
Name: bonanza-ugc
Version: 0.1.0
Summary: AI-generated UGC videos via Higgsfield Marketing Studio
Author: Bonanza Labs
License-Expression: MIT
Keywords: ugc,ai,video,higgsfield,marketing
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Video
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# Bonanza UGC

AI-generated UGC videos via Higgsfield Marketing Studio.

## Install

```bash
pip install bonanza-ugc
```

## Quick Start

```python
from bonanza_ugc import UGCGenerator, UGCConfig

gen = UGCGenerator()
video = gen.generate(
    prompt="A stylish young woman shows off her silver chain necklace...",
    avatar="mei",
    mode="ugc",
    duration=15,
)
print(f"Video URL: {video.result_url}")
print(f"Virality: {video.virality_score}/100")
```

## CLI

```bash
# Generate a video
ugc generate --prompt "..." --avatar mei --mode ugc

# Use a template
ugc generate --template silverjstore --product "Venetian Chain" --avatar mei

# Score virality
ugc score <video_path_or_url>

# List avatars
ugc avatars

# Batch generate
ugc batch --leads leads.json --mode ugc
```

## Features

- 🎬 Generate UGC videos with AI avatars
- 📊 Score video virality with Brain Activity analysis
- 🎯 Prompt templates for product categories
- 📦 Batch generation support
- 🔄 Product URL fetching and integration

## License

MIT
