---
title: RAFIQ Arabic ASR
emoji: 🎙️
colorFrom: green
colorTo: blue
sdk: docker
pinned: false
---

# RAFIQ – Egyptian Arabic Speech-to-Text API

Custom character-level Transformer trained on Egyptian Arabic audio.  
Built as part of the **RAFIQ** autism-support platform – FCAI, Beni-Suef University 2026.

## Usage

1. Upload your model file as `entire_model.pth` to the Space files.
2. Open `/docs` for the interactive Swagger UI.
3. `POST /transcribe` with a WAV/MP3/OGG file (≤ 15 s).

## Endpoints

| Method | Path | Description |
|--------|------|-------------|
| GET | `/` | API info |
| GET | `/health` | Model status + config |
| POST | `/transcribe` | Upload audio → Arabic text |

## Model config
- Character-level vocab (Arabic + English) – 74 tokens  
- Encoder: 2 layers, Decoder: 1 layer, d_model=512, 8 heads  
- Input: 128-mel spectrogram, 15-second chunks  
- Sample rate: 16 000 Hz