README.md

metadata

title: Live Football Commentary Translator
emoji: ⚽
colorFrom: green
colorTo: blue
sdk: gradio
sdk_version: 5.42.0
python_version: '3.11'
app_file: app.py
pinned: false
license: apache-2.0

Live Football Commentary Translator

Speak (or upload) commentary in one language, hear it spoken in another.

What this is

A HuggingFace Space that translates football commentary between languages. Two modes:

• Single clip — record or upload one clip, get one translation.
• Continuous live — start a session, speak naturally, translations chunk at natural pauses (~0.8s silence) and play sequentially.

Sources: English, Scottish English, German, Spanish, Arabic Targets: all of the above + Swahili, Amharic, Afrikaans

How it works

Two pipelines, routed by target language:

Target language	Pipeline	Cost
English, Scottish-EN, German, Spanish, Arabic	Single Qwen-Omni call: audio in → translated speech out	1 API call
Swahili, Amharic, Afrikaans	Qwen-Omni (audio → translated text), then YourVoic (text → speech)	2 API calls

Qwen-Omni is qwen3.5-omni-plus on DashScope International. YourVoic is the fallback for languages Qwen-Omni doesn't cover natively. This split exists because Qwen-Omni does not produce intelligible speech in Swahili, Amharic, or Afrikaans on its own.

Deploy

1. Create a new HuggingFace Space, SDK = Gradio
2. Upload app.py, requirements.txt, and this README.md
3. Add secrets in Settings → Variables and secrets:
   • DASHSCOPE_API_KEY (required) — get one from DashScope International
   • YOURVOIC_API_KEY (required for Swahili/Amharic/Afrikaans only)
4. (Recommended) Set hardware to ZeroGPU if you have access. CPU also works but will be slower on the audio-decode steps.

Expected latency

On free ZeroGPU, expect 3-8 seconds from end-of-speech to start-of-output. The demo is designed to feel "live-ish" but not simultaneous-interpretation grade. Speak in short bursts — one play, one tackle, one moment — rather than long monologues.

Known limitations

• "Scottish English" is treated as accented English in the system prompt rather than a separate language. Qwen-Omni's Scottish accent is decent but not authentic.
• YourVoic voice support per language is sparsely documented. The code falls back to a universal voice ("Peter") if the primary choice fails.
• Arabic voice cloning is intentionally not exposed — the underlying qwen3-tts-vc model doesn't support Arabic.
• Free-tier ZeroGPU has cold-start delays. First call after idle is slower.

Files

• app.py — Gradio UI and pipeline
• requirements.txt — Python dependencies
• README.md — this file (also the Space metadata header)