# WaveSpeed TikTok Text Pipeline — Setup Guide

Generates TikTok-style short-form videos: AI image → AI video → paragraph text burned in.

---

## Prerequisites

### 1. Claude Code (Desktop App)
Download and install from: https://claude.ai/download

### 2. Python 3.9+
Download from: https://www.python.org/downloads/
- **Windows:** tick "Add Python to PATH" during install
- Verify: `py --version` or `python --version`

Install the one required library:
```
pip install requests
```

### 3. FFmpeg
Required for Stage 3 (text overlay).

**Windows:**
- Download from: https://www.gyan.dev/ffmpeg/builds/ (grab the "full build" release zip)
- Extract it, then add the `bin/` folder to your system PATH
- Verify: `ffmpeg -version` in a terminal

**Mac:**
```
brew install ffmpeg
```

**Linux:**
```
sudo apt install ffmpeg
```

---

## Install the Skill

1. Unzip `wavespeed-tiktok-text.zip`
2. Move the `wavespeed-tiktok-text` folder to:
   - **Windows:** `C:\Users\<YourName>\.claude\skills\`
   - **Mac/Linux:** `~/.claude/skills/`

   Result should be: `~/.claude/skills/wavespeed-tiktok-text/SKILL.md`

---

## You'll Also Need

- **WaveSpeed API key** — sign up at https://wavespeed.ai and grab a key from your dashboard
- **Avatar image** — upload your reference photo to https://imgbb.com and copy the direct `i.ibb.co` link

---

## Run It

1. Open Claude Code desktop app
2. Start a new conversation
3. Type: `run the tiktok wavespeed pipeline for a new avatar from scratch`
4. Claude will walk you through entering your persona name, avatar URL, and API key, then generate clips

---

## Cost

~$0.32 per clip (Stage 1: ~$0.04 image + Stage 2: ~$0.28 video + Stage 3: free FFmpeg)

Default batch is 5 clips (~$1.60). You choose N at runtime.