UPLOAD_TEMPLATES_GUIDE.md

# Quick Guide: Adding Video Templates to HuggingFace Space

## Steps to Upload Templates from assets.zip

### 1. Download and Extract
1. Download `assets.zip` from: https://drive.google.com/file/d/1dg0SDAxEARClYq_6L1T1XIfWvC5iA8WD/view
2. Extract the zip file on your computer
3. You should see a structure like:
   ```
   assets/
   ├── video_template/
   │   ├── dance_indoor_1/
   │   │   ├── sdc.mp4
   │   │   ├── vid.mp4
   │   │   └── ...
   │   ├── sports_basketball_gym/
   │   └── ...
   ```

### 2. Upload to HuggingFace Space

**Option A: Via Web Interface (Easier)**
1. Go to your Space: https://huggingface.co/spaces/minhho/mimo-1.0
2. Click on **"Files"** tab
3. Navigate to or create: `assets/video_template/`
4. Click **"Add file"** → **"Upload files"**
5. Drag and drop template folders (or individual files)
6. Commit the changes

**Option B: Via Git (Better for many files)**
```bash
# Clone your space repository
git clone https://huggingface.co/spaces/minhho/mimo-1.0
cd mimo-1.0

# Copy templates from extracted assets.zip
cp -r /path/to/extracted/assets/video_template/* ./assets/video_template/

# Important: Don't add binary files to git without LFS
# Instead, add them one folder at a time through web interface
# OR set up Git LFS:

git lfs install
git lfs track "assets/video_template/**/*.mp4"
git add .gitattributes
git add assets/video_template/
git commit -m "Add video templates"
git push
```

### 3. Verify Templates Loaded

After uploading:
1. Go back to your Space app
2. Click **"🔄 Refresh Templates"** button
3. The dropdown should now show your uploaded templates

## Which Templates to Upload First

If space is limited, prioritize these:
1. **dance_indoor_1** - Popular dance motion
2. **sports_basketball_gym** - Sports motion
3. **movie_BruceLee1** - Martial arts action
4. **shorts_kungfu_desert1** - Another action template

Each template folder should contain **at minimum**:
- `sdc.mp4` (REQUIRED - pose skeleton video)
- Other files (vid.mp4, bk.mp4, occ.mp4) are optional but improve quality

## Expected File Sizes
- Each template: ~10-50 MB
- Full template set: ~200-500 MB
- HuggingFace Spaces free tier: ~50GB storage (plenty for templates)

## Troubleshooting

### "No templates available" message
- Templates not uploaded yet
- Check file structure: must be in `assets/video_template/[template_name]/`
- Each template folder must have `sdc.mp4`

### Upload fails / Space crashes
- Try uploading one template at a time
- Use smaller templates first
- Consider using Git LFS for large files

### Templates don't show after upload
- Click "🔄 Refresh Templates" button
- Restart the Space (Settings → Factory reboot)
- Check file permissions (should be readable)

## Alternative: Work Without Templates

The app works perfectly fine WITHOUT templates:
- Use **reference image only** mode
- Generate animations based on the input image
- Upload templates later when convenient

Templates enhance variety but aren't required for core functionality!