3d-nerf / QUICK_DEPLOY_CHECKLIST.md
Tohru127's picture
Upload 14 files
d99a295 verified

A newer version of the Gradio SDK is available: 6.2.0

Upgrade

Quick HF Pro Deployment Checklist

βœ… YES, You Can Host This on Hugging Face Pro!

What You Need:

  • βœ… HF Pro account ($9/month) - YOU HAVE THIS
  • βœ… Additional GPU costs (~$10-30/month for personal use)
  • βœ… Files ready to upload

5-Minute Setup

1. Create Space (2 min)

huggingface.co/spaces β†’ "Create new Space"
Name: nerf-3d-reconstruction
SDK: Gradio
Visibility: PRIVATE ⚠️
Hardware: CPU basic (change later)

2. Upload Files (1 min)

βœ… app.py (rename app-10.py)
βœ… requirements.txt
βœ… packages.txt
βœ… README.md

3. Change Hardware (1 min)

Settings β†’ Hardware β†’ A10G Small
Cost: ~$1.05/hour
Save

4. Wait for Build (10 min)

Watch Logs tab
Wait for: "Running on local URL: http://0.0.0.0:7860"

5. Test (45 min)

Upload video β†’ Process β†’ Download model

Expected Costs

Your Situation (HF Pro):

Scenario Cost/Month
Pro subscription $9 (already paid)
10 reconstructions +$10-15 GPU
Total ~$20-25/month

Cost per Reconstruction:

  • T4: $0.60/hour Γ— 0.75hr = ~$0.45
  • A10G: $1.05/hour Γ— 0.75hr = ~$0.80
  • A100: $3/hour Γ— 0.5hr = ~$1.50

Critical Settings

⚠️ MUST DO:

  1. Visibility: PRIVATE (avoid unexpected costs)
  2. Sleep timeout: 15 minutes (auto-pause)
  3. GPU: A10G Small (best value)

⚠️ DON'T DO:

  1. ❌ Make it Public (anyone can use = $$$)
  2. ❌ Use CPU (won't work for NeRF)
  3. ❌ Forget to monitor costs

Will It Work?

βœ… YES, Because:

  • HF Pro has longer timeouts
  • GPU hardware available
  • 20-45 min processing fits within limits
  • COLMAP can be installed via packages.txt

⚠️ Limitations:

  • One user at a time (single GPU)
  • Costs add up with heavy use
  • Still takes 20-45 minutes per video

Files Ready to Deploy

All files are in /mnt/user-data/outputs/:

  • βœ… requirements.txt
  • βœ… requirements-zerogpu.txt (don't use this)
  • βœ… packages.txt
  • βœ… HF_PRO_DEPLOYMENT.md (full guide)

Just need:

  • βœ… Rename app-10.py β†’ app.py
  • βœ… Create simple README.md

Recommended Configuration

Space Name: nerf-3d-reconstruction
SDK: Gradio 4.0
Hardware: A10G Small
Visibility: Private
Sleep: 15 min

Monthly cost: ~$20-30 total (including Pro)


Next Steps

  1. Create Space on HF
  2. Upload files
  3. Set to A10G Small + Private
  4. Test with one video
  5. Monitor costs for a week
  6. Adjust as needed

Time to deploy: 15 minutes Time to first result: 30-60 minutes


Quick FAQ

Q: Can I use ZeroGPU instead? A: ❌ NO - ZeroGPU times out after 60 seconds, your app needs 20-45 minutes

Q: Can I make it Public? A: ⚠️ Not recommended - you'll pay for everyone's usage

Q: What if I run out of credits? A: Add payment method, HF will charge your card for GPU usage

Q: Can I pause the Space when not using? A: βœ… Yes - auto-sleeps after 15 min, or manually pause in settings

Q: Will COLMAP work? A: βœ… Yes - packages.txt installs it automatically


πŸš€ Ready to deploy? Start with the 5-minute setup above!

See HF_PRO_DEPLOYMENT.md for detailed instructions.