README.md

---
title: SP4D Demo
emoji: 🎥
colorFrom: gray
colorTo: gray
sdk: gradio
sdk_version: 5.49.1
app_file: app.py
pinned: true
short_description: Demo with SP4D's Video-to-4D new model.
---

# SP4D Hugging Face Space (template)


This repository is a Gradio-based Hugging Face Space that provides a UI for Stability AI's **SP4D** model (Stable Part Diffusion 4D).


## What this Space does
- Accepts a 4-frame input (video file or a ZIP of 4 frames)
- Provides basic inference controls (guidance scale, seed)
- Attempts to run a local SP4D pipeline if the repo is installed in the environment
- If SP4D is not installed, shows step-by-step instructions for installing and running the model


## Quick start (recommended for Spaces with GPU)
1. Add a repository secret named `HF_TOKEN` (your Hugging Face token) in the Space settings if needed.
2. Edit `requirements.txt` and uncomment the line to install the Stability-AI repo if you want an automated install: