⚠️ IMPORTANT: Follow these steps in order ⚠️

═══════════════════════════════════════════════════════════════
🚀 HuggingFace Spaces Deployment - Step by Step
═══════════════════════════════════════════════════════════════

📋 PREREQUISITES
═══════════════════════════════════════════════════════════════
☐ HuggingFace account created: https://huggingface.co/join
☐ HuggingFace token obtained: https://huggingface.co/settings/tokens
   (Create new token with "write" access)
☐ HuggingFace CLI installed (already done ✓)

═══════════════════════════════════════════════════════════════
🎯 DEPLOYMENT STEPS
═══════════════════════════════════════════════════════════════

Choose ONE method below:

┌─────────────────────────────────────────────────────────────┐
│ METHOD 1: AUTOMATED SCRIPT (EASIEST) ⭐                     │
└─────────────────────────────────────────────────────────────┘

1. Open PowerShell in this directory:
   d:\2025-vibe-coding\ACE-Step-Custom

2. Run the deployment script:
   .\deploy_hf.bat

3. Follow the prompts:
   - Login with your HF token
   - Enter Space name (e.g., "ace-step-custom")
   - Wait for upload

┌─────────────────────────────────────────────────────────────┐
│ METHOD 2: MANUAL CLI (FOR DEVELOPERS)                       │
└─────────────────────────────────────────────────────────────┘

1. Login to HuggingFace:
   huggingface-cli login
   [Paste your token]

2. Create the Space:
   huggingface-cli repo create ace-step-custom --type space --space_sdk gradio

3. Upload files:
   huggingface-cli upload YOUR_USERNAME/ace-step-custom . --repo-type space

┌─────────────────────────────────────────────────────────────┐
│ METHOD 3: WEB INTERFACE (NO CLI NEEDED)                     │
└─────────────────────────────────────────────────────────────┘

1. Go to: https://huggingface.co/new-space

2. Fill in Space details:
   Name: ace-step-custom
   License: MIT
   SDK: Gradio
   Hardware: A10G Small

3. Click "Create Space"

4. Click "Files and versions" → "Add file" → "Upload files"

5. Upload these files/folders:
   ✓ app.py
   ✓ requirements.txt
   ✓ config.yaml
   ✓ README.md
   ✓ LICENSE
   ✓ .gitignore
   ✓ src/ (entire folder)
   ✓ scripts/ (entire folder)

6. Commit changes

═══════════════════════════════════════════════════════════════
⚙️ POST-DEPLOYMENT CONFIGURATION
═══════════════════════════════════════════════════════════════

After upload, configure your Space:

1. ☐ Go to your Space URL:
   https://huggingface.co/spaces/YOUR_USERNAME/ace-step-custom

2. ☐ Click "Settings" tab

3. ☐ Configure Hardware:
   - Select: "A10G Small" (24GB VRAM) - MINIMUM
   - Or: "A100 Large" (40GB VRAM) - RECOMMENDED
   - Click "Save"

4. ☐ Set Python version: 3.10 (should be automatic)

5. ☐ Set timeout: 30 minutes (optional, for long generations)

6. ☐ Enable Discussions (optional, for user feedback)

═══════════════════════════════════════════════════════════════
⏱️ BUILD & TESTING
═══════════════════════════════════════════════════════════════

1. ☐ Wait for build to complete:
   - Click "Logs" tab to monitor
   - First build: 5-10 minutes
   - Model download: ~7GB (first run only)

2. ☐ Space will show "Running" when ready

3. ☐ Test Tab 1 (Standard ACE-Step):
   - Enter prompt: "Happy pop song with piano"
   - Set duration: 10 seconds
   - Click "Generate"
   - Verify audio plays

4. ☐ Test Tab 2 (Timeline Workflow):
   - Enter prompt and lyrics
   - Set context length: 30 seconds
   - Click "Generate Clip"
   - Verify timeline updates

5. ☐ Test Tab 3 (LoRA Training):
   - Upload 2-3 test audio files
   - Set epochs to 2
   - Click "Start Training"
   - Verify progress updates

═══════════════════════════════════════════════════════════════
💰 COST MANAGEMENT
═══════════════════════════════════════════════════════════════

GPU Costs:
- A10G Small (24GB): ~$1.05/hour ⭐ RECOMMENDED
- A100 Large (40GB): ~$4.13/hour

Auto-Sleep:
✓ Space sleeps automatically after 48 hours of inactivity
✓ Wakes up on first request (30-60 second startup)
✓ No charges while sleeping

Testing Budget:
- Initial testing: ~$5-10
- Active use: ~$10-50/month
- Production: Scale as needed

═══════════════════════════════════════════════════════════════
🐛 TROUBLESHOOTING
═══════════════════════════════════════════════════════════════

Problem: Space won't start
Solution: 
- Check "Logs" tab for errors
- Verify all files uploaded
- Ensure README.md has YAML frontmatter

Problem: Out of memory error
Solution:
- Upgrade to A100 Large
- Reduce generation duration in UI
- Lower batch size in LoRA training

Problem: Slow generation
Solution:
- Verify GPU is enabled (not CPU)
- Check Space isn't sleeping
- Reduce sampling steps in config

Problem: Model download fails
Solution:
- Check HuggingFace Hub status
- Verify internet connectivity
- Wait and retry

═══════════════════════════════════════════════════════════════
✅ SUCCESS CHECKLIST
═══════════════════════════════════════════════════════════════

Before announcing your Space:

☐ All three tabs tested and working
☐ Example generations added to README
☐ Clear usage instructions visible
☐ GPU enabled (A10G Small minimum)
☐ Error handling tested
☐ Mobile view checked
☐ Discussions enabled
☐ License properly displayed
☐ Contact/support info added
☐ Share link works

═══════════════════════════════════════════════════════════════
🎉 GO LIVE!
═══════════════════════════════════════════════════════════════

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

Share it:
□ Twitter/X: "Just deployed ACE-Step 1.5 Custom on @huggingface! 🎵 
   Check it out: [your-url] #AIMusic #HuggingFace #ACEStep"
□ LinkedIn post
□ Reddit (r/MachineLearning, r/artificial, r/WeAreTheMusicMakers)
□ Discord communities
□ Personal blog/portfolio

═══════════════════════════════════════════════════════════════
📚 ADDITIONAL RESOURCES
═══════════════════════════════════════════════════════════════

Documentation:
- DEPLOY_QUICK.md - Quick reference
- DEPLOYMENT.md - Complete guide
- README.md - Project documentation

Support:
- HuggingFace Docs: https://huggingface.co/docs/hub/spaces
- HuggingFace Discord: https://discord.gg/huggingface
- GitHub Issues: [your-repo-url]

═══════════════════════════════════════════════════════════════

Ready to deploy? 🚀

Run: .\deploy_hf.bat

═══════════════════════════════════════════════════════════════