| --- |
| title: Auris Nigerian Accented ASR |
| emoji: 🎙️ |
| colorFrom: purple |
| colorTo: gray |
| sdk: gradio |
| app_file: app.py |
| pinned: false |
| --- |
| |
| # Auris transcription service |
|
|
| Wraps [`NCAIR1/NigerianAccentedEnglish`](https://huggingface.co/NCAIR1/NigerianAccentedEnglish) |
| (a Whisper-small fine-tune on Nigerian-accented English) as a Gradio app running on |
| free ZeroGPU hardware, for the Auris app's chunked recording pipeline. |
|
|
| ## API |
|
|
| Exposed as the `/transcribe` endpoint (see the Space's "Use via API" link once running). |
|
|
| - Inputs: `audio` (file/blob), `secret` (string — must match the `API_SECRET` below) |
| - Output: transcript text |
| - Errors (bad secret, no audio, transcription failure) surface as Gradio errors, which |
| the `@gradio/client` caller sees as a `status` event with `stage: "error"`. |
|
|
| Called from Node via `@gradio/client`'s `Client.submit()`, not raw HTTP — this gives the |
| caller real queue/cold-start visibility (`stage: "pending"`, `eta`, `position`) instead of |
| a single opaque request. |
|
|
| ## Configuration |
|
|
| Set both of these as **Space secrets** (Settings → Variables and secrets): |
|
|
| - `HF_TOKEN` — a HuggingFace access token (Read scope, with **"Read access to contents of |
| all public gated repos you can access"** enabled) belonging to an account that has |
| requested/been granted access on the |
| [model page](https://huggingface.co/NCAIR1/NigerianAccentedEnglish). Without this the |
| app starts but every call fails with a gated-repo error. |
| - `API_SECRET` — a shared secret of your choosing, so random visitors to this public |
| Space can't burn through your ZeroGPU quota. The calling backend must send the same |
| value as the `secret` input. |
|
|
| ## Hardware |
|
|
| Must be created with **ZeroGPU** hardware (the only free GPU tier as of writing). |
| Model weights load once at startup (CPU); each call moves the model to the allocated |
| GPU for the duration of that call and back to CPU afterward, since ZeroGPU only grants |
| GPU access for the lifetime of a single `@spaces.GPU`-decorated call. |
|
|
| If the build or first call fails with a torch/CUDA compatibility error, check HF's |
| current [ZeroGPU docs](https://huggingface.co/docs/hub/spaces-zerogpu) for the |
| currently-supported `torch` version range and pin it in `requirements.txt` — package |
| versions drift over time and aren't pinned here. |
|
|
