DEPLOY.md

Deployment Guide — HuggingFace Space

Quick Deploy (3 steps)

Step 1: Create a new HuggingFace Space

1. Go to huggingface.co/new-space
2. Fill in:
   • Owner: PlotweaverAI (or your account)
   • Space name: live-football-commentary-en-yo
   • SDK: Gradio
   • Hardware: T4 small (GPU required — free tier CPU won't work well)
   • Visibility: Public
3. Click Create Space

Step 2: Upload the files

Upload these 3 files to the Space repo (via the web UI or git):

├── README.md           ← Space metadata (hardware, tags, etc.)
├── app.py              ← Main Gradio application
└── requirements.txt    ← Python dependencies

Option A — Web upload:

• Go to your Space → Files → "Add file" → Upload each file

Option B — Git (recommended):

# Clone the space
git clone https://huggingface.co/spaces/PlotweaverAI/live-football-commentary-en-yo
cd live-football-commentary-en-yo

# Copy the files
cp /path/to/hf_space/* .

# Push
git add .
git commit -m "Initial deploy: EN→YO commentary pipeline"
git push

Step 3: Wait for build

The Space will automatically:

1. Install dependencies from requirements.txt
2. Download all 3 models from HuggingFace Hub
3. Start the Gradio app

First build takes ~5-10 minutes (model downloads). Subsequent restarts are faster due to caching.

---

Hardware Notes

Hardware	Cost	Performance
T4 small	~$0.60/hr	Good — full pipeline in ~6-10s
T4 medium	~$1.00/hr	Better for concurrent users
A10G small	~$1.05/hr	Fastest inference
CPU basic	Free	Very slow (~60s+), not recommended

The Space will sleep after 48 hours of inactivity on paid hardware. You can enable "persistent" mode in Space settings to keep it running.

---

Troubleshooting

Space keeps crashing / OOM:

• T4 small has 16GB VRAM — should be enough for all 3 models in float16
• If issues persist, try T4 medium

Models fail to load:

• Make sure all 3 model repos are public on HuggingFace
• If private, add a HF_TOKEN secret in Space settings

Audio recording doesn't work:

• Browser mic access requires HTTPS (HuggingFace Spaces provides this)
• Make sure you've granted microphone permission in the browser

---

Customization

To add more source/target languages (your MT model supports 6): Edit app.py and add a language dropdown to the Gradio UI. Your NLLB model likely supports these codes:

• eng_Latn (English)
• yor_Latn (Yoruba)
• ibo_Latn (Igbo)
• hau_Latn (Hausa)
• Check your model card for the full list.