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)

# 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!