DEPLOY_QUICK.md

Quick Deployment to HuggingFace Spaces

Prerequisites

✅ HuggingFace account: https://huggingface.co/join ✅ HuggingFace token: https://huggingface.co/settings/tokens

Fastest Method (Windows)

Run the deployment script:

cd d:\2025-vibe-coding\ACE-Step-Custom
.\deploy_hf.bat

The script will:

1. Install HuggingFace CLI (if needed)
2. Login to your account
3. Create new Space
4. Upload all files
5. Provide your Space URL

Fastest Method (Linux/Mac)

cd /path/to/ACE-Step-Custom
chmod +x deploy_hf.sh
./deploy_hf.sh

Manual Deployment (If Script Fails)

1. Install HuggingFace CLI

pip install huggingface_hub

2. Login

huggingface-cli login

Enter your token from: https://huggingface.co/settings/tokens

3. Create Space

huggingface-cli repo create ace-step-custom --type space --space_sdk gradio

4. Upload Files

cd d:\2025-vibe-coding\ACE-Step-Custom
huggingface-cli upload YOUR_USERNAME/ace-step-custom . --repo-type space

Replace YOUR_USERNAME with your HuggingFace username.

After Upload

1. Configure GPU

• Go to your Space: https://huggingface.co/spaces/YOUR_USERNAME/ace-step-custom
• Click "Settings" tab
• Under "Hardware", select: A10G Small (recommended)
• Click "Save"

2. Wait for Build

• Space will build automatically (5-10 minutes)
• Check "Logs" tab for progress
• Model downloads on first run (~7GB)

3. Test Your Space

1. Open Space URL
2. Test Tab 1: Generate 10-second clip
3. Test Tab 2: Generate timeline clip
4. Test Tab 3: Upload test audio

Troubleshooting

Login Failed:

# Make sure you copied the full token
huggingface-cli whoami  # Check if logged in

Upload Failed:

# Try with explicit exclusions
huggingface-cli upload YOUR_USERNAME/ace-step-custom . --repo-type space --exclude "*.pyc" --exclude "outputs/*" --exclude "__pycache__/*"

Space Not Starting:

• Check "Logs" tab for errors
• Verify requirements.txt is uploaded
• Ensure README.md has correct YAML frontmatter

Out of Memory:

• Upgrade GPU in Settings
• Start with A10G Small minimum

Your Space URL

After deployment:

https://huggingface.co/spaces/YOUR_USERNAME/ace-step-custom

Cost Estimate

• A10G Small (24GB): ~$1.05/hour
• Auto-sleep: Space sleeps when inactive (no charge)
• Testing: Budget ~$5-10 for initial testing

Need Help?

See full guide: DEPLOYMENT.md

Next Steps

1. ✅ Deploy Space
2. ✅ Test all features
3. ✅ Enable Discussions in Settings
4. ✅ Add example outputs to README
5. ✅ Share your Space!

---

🎵 Happy testing! Your Space will be live in minutes! 🚀