---
title: Rabah Tarteel I
emoji: 🕌
colorFrom: yellow
colorTo: green
sdk: docker
app_port: 7860
pinned: true
license: apache-2.0
---

# 🕌 Real-time Quranic Arabic Transcription (Whisper)

This Space runs a **FastAPI + WebSocket** backend for *real-time Quranic Arabic speech recognition*  
using the model [tarteel-ai/whisper-base-ar-quran](https://huggingface.co/tarteel-ai/whisper-base-ar-quran).

### 🧠 Features
- 🎙 Real-time microphone streaming via WebSocket  
- ⚡ Powered by Whisper fine-tuned on Quranic recitations  
- 🧩 Dockerized for Hugging Face Spaces  
- ✅ Safe model caching in `/tmp` for low disk usage  

### 🏗️ Tech Stack
- **FastAPI** (WebSocket backend)
- **Transformers** (Whisper model)
- **Torch**, **SoundFile**, **NumPy**
- **Docker** (for Hugging Face Spaces deployment)

### 🚀 Run locally
```bash
docker build -t quran-asr .
docker run -p 7860:7860 quran-asr