README.md

Foley Studio (ZeroGPU) — HunyuanVideo-Foley

Custom Gradio front-end for tencent/HunyuanVideo-Foley with:

• ZeroGPU execution via @spaces.GPU(duration=240)
• Smart preprocessing (auto-trim to ~20s, downscale to 480p)
• Mux option to deliver MP4 with foley track
• Batch-Lite queue for 1–3 short clips
• Simple branding via env vars

Space setup

• Type: Gradio
• Hardware: ZeroGPU
• Dev Mode: ON
• Add files: app.py, requirements.txt, postBuild, README.md

Optional ENV:

• BILS_BRAND (default: "Bilsimaging · Foley Studio")
• PRIMARY_COLOR (hex, default: #6B5BFF)
• MAX_SECS (default: 22)
• TARGET_H (default: 480)
• TARGET_SR (default: 48000)

Usage

1. Upload a short video (≤ ~20s recommended).
2. (Optional) Add a sound prompt.
3. Click Generate.
4. Download the WAV and/or muxed MP4.