musehersi/somali-stt-platform

🎙️ Free Somali Speech-to-Text platform — powered by wav2vec2-somali (WER 0.20) # 🎙️ Somali Speech-to-Text Platform **The first free, community-facing Somali automatic speech recognition web platform.** Transcribe Somali audio and video online — powered by `ooloteam/wav2vec2-somali`, the best open-source Somali ASR model with **WER 0.20**. ## ✨ Features - 🎵 **Audio** — MP3, WAV, OGG, FLAC, M4A, OPUS - 🎬 **Video** — MP4, WebM, MKV, MOV (audio extracted automatically) - ⬇️ **Download** transcript as `.txt` - ⚡ **Chunked inference** — handles files up to 10 minutes - 🔒 **Private** — files are never stored - 🆓 **Free forever** — ad-supported, no account required ## 🏗️ Architecture ``` User Browser │ ├── Next.js 14 (Vercel CDN - Free) │ │ │ └── /api/transcribe (Vercel Edge Function) │ │ │ └── HuggingFace Gradio Space │ │ │ └── ooloteam/wav2vec2-somali │ (wav2vec2, 315M params, WER 0.20) ``` ## 🚀 Quick Start ### 1. Clone & Install ```bash git clone github.com cd somali-stt-platform npm install ``` ### 2. Configure Environment ```bash cp .env.example .env.local # Edit .env.local — set HF_SPACE_URL ``` ### 3. Run Development Server ```bash npm run dev # Open localhost ``` ### 4. Deploy to Vercel ```bash npx vercel --prod ``` Or click the **Deploy with Vercel** button above. ## ⚙️ Environment Variables | Variable | Description | Default | |----------|-------------|---------| | `HF_SPACE_URL` | HuggingFace Gradio Space API URL | `ooloteam-somalispeechtotext…` | ## 📁 Project Structure ``` somali-stt-platform/ ├── app/ │ ├── layout.tsx # Root layout + metadata │ ├── page.tsx # Main transcription interface │ ├── globals.css # Global styles + Tailwind │ ├── about/ │ │ └── page.tsx # About page │ ├── api-docs/ │ │ └── page.tsx # API documentation page │ └── api/ │ └── transcribe/ …