ENABLE_GPU.md

🚀 How to Enable GPU on Your Hugging Face Space

Your Space is currently running in MOCK MODE because GPU is not enabled.

⚠️ Current Issue

User provided device_type of 'cuda', but CUDA is not available

This means your Space is running on CPU, but FIBO requires GPU.

✅ Solution: Enable GPU

Step 1: Go to Space Settings

1. Open your Space: https://huggingface.co/spaces/ThomasChauv/FIBO-virtual-photo-studio
2. Click ⚙️ Settings (top right)

Step 2: Change Hardware

1. Scroll to Hardware section
2. Current: CPU basic (free)
3. Click Change hardware

Step 3: Select GPU

Choose one of:

Hardware	VRAM	Speed	Cost
GPU basic (T4)	16GB	Good	Free for Community
GPU small (A10G)	24GB	Better	Paid
GPU medium (A100)	40GB	Best	Paid

Recommended: Start with GPU basic (T4) - it's free and sufficient for FIBO!

Step 4: Save & Restart

1. Click Save
2. Space will restart (~2 minutes)
3. Watch logs for: ✅ FIBO on GPU: Tesla T4

📊 What to Expect

With CPU (Current - Not Working):

⚠️ User provided device_type of 'cuda', but CUDA is not available
❌ Failed to load FIBO
✅ Generation complete! (Mock mode - placeholder images)

With GPU (After Fix - Working):

🔄 Loading FIBO pipelines...
📦 Loading FIBO-VLM (prompt-to-JSON)...
✅ VLM loaded
📦 Loading FIBO-8B (image generation)...
✅ FIBO on GPU: Tesla T4
🎉 FIBO Ready!

[Generate button clicked]
📝 Prompt: studio product shot...
🔄 Generating structured JSON prompt...
✅ JSON prompt: 1247 chars
🎨 Generating 4 image(s) (28 steps, 1024x1024)...
✅ Done in 15.3s
[Real images displayed!]

🎯 Quick Checklist

Before GPU:

• Space shows "Mock mode" message
• Placeholder beige images
• Logs show "CUDA is not available"

After GPU:

• No "Mock mode" message
• Real generated images
• Logs show "FIBO on GPU: Tesla T4"
• Generation takes 10-20 seconds

💡 Tips

1. First generation: Takes ~3-5 minutes (model download)
2. Subsequent: Takes ~10-20 seconds (fast!)
3. Free tier: T4 GPU is free with Hugging Face Community account
4. Persistent storage: Enable for faster restarts (optional)

🆘 Still Having Issues?

If you enabled GPU but still see mock mode:

1. Check logs for specific error (ujson, boltons, etc.)
2. Wait 3-5 minutes for models to download on first run
3. Restart Space if it's stuck
4. Check disk space (~20GB needed for models)

📚 Resources

• HF Spaces Hardware Docs
• FIBO Model Card
• Troubleshooting Guide

---

TL;DR: Go to Settings → Hardware → Select "GPU basic (T4)" → Save → Wait 2 min → FIBO will work! 🚀