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:

```powershell
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)

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

## Manual Deployment (If Script Fails)

### 1. Install HuggingFace CLI
```powershell
pip install huggingface_hub
```

### 2. Login
```powershell
huggingface-cli login
```
Enter your token from: https://huggingface.co/settings/tokens

### 3. Create Space
```powershell
huggingface-cli repo create ace-step-custom --type space --space_sdk gradio
```

### 4. Upload Files
```powershell
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:**
```powershell
# Make sure you copied the full token
huggingface-cli whoami  # Check if logged in
```

**Upload Failed:**
```powershell
# 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](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! 🚀