README.md

# dee-video-studio

**HyperFrames x GitHub Actions x Hugging Face**  
Testimonial video pipeline for Dee Ferdinand AI / MAIN AI.  
No HeyGen subscription. No paid API. 100% open-source.

---

## Pipeline

```
Google Drive MOV
  → gdown download (GitHub Actions)
  → ffmpeg MOV→MP4
  → patch_composition.py (inject name/role/quote)
  → npx hyperframes render (headless Chrome + ffmpeg)
  → HuggingFace dataset: AIgoose/video-renders
```

---

## Run a render

**Actions → Render Testimonial Video → Run workflow**

| Input | What to fill |
|-------|-------------|
| `gdrive_file_id` | The ID from the Drive share URL |
| `participant_name` | For the lower-third (e.g. Budi Santoso) |
| `participant_role` | Role line (e.g. Head of Digital · PT Maju) |
| `pull_quote` | Strongest spoken line in Indonesian |

Output lands at:  
`https://huggingface.co/datasets/AIgoose/video-renders/resolve/main/renders/<filename>.mp4`

---

## One-time setup

1. **GitHub Secret**: Settings → Secrets → `HF_TOKEN` (your HF write token from hf.co/settings/tokens)
2. **Drive permission**: Set the MOV to "Anyone with the link" → Viewer

---

## Composition overlay map

| Overlay | Timing | Description |
|---------|--------|-------------|
| Name card | 0–4s | Program name + brand |
| Lower-third | 8–18s | Participant name + role |
| Pull quote | 30–48s | Strongest spoken line |
| Stat callout | 52–64s | 1,000+ professionals trained |
| Feature chips | 66–78s | 80% hands-on, langsung praktek, real output |
| Brand outro | 83–90s | Dee Ferdinand AI CTA |

---

HyperFrames: https://github.com/heygen-com/hyperframes