---
language:
- kmr
license: mit
library_name: transformers
tags:
- automatic-speech-recognition
- wav2vec2-bert
- kurdish
- badini
- kurmanji
- low-resource
base_model: facebook/w2v-bert-2.0
pipeline_tag: automatic-speech-recognition
---

# Badini Kurdish ASR — Normalized (Wav2Vec2-BERT)

An automatic speech recognition (ASR) model for **Badini Kurdish** (a variety of
Kurmanji, written in Arabic script), fine-tuned from
[`facebook/w2v-bert-2.0`](https://huggingface.co/facebook/w2v-bert-2.0)
with a CTC head.

This repository includes a companion text-normalization module (`badini_normalize.py`) alongside the model. Following the usage example below applies punctuation handling, number expansion, and character normalization to the raw model output.

## Input requirements

- Audio must be **16 kHz, mono**.
- Resample any other sample rate to 16 kHz before inference.

## Usage

```python
import torch, soundfile as sf
from transformers import Wav2Vec2BertForCTC, Wav2Vec2BertProcessor
from huggingface_hub import hf_hub_download
import importlib.util

repo_id = "computeram/badini-w2v-bert-normalized"

# download and load the companion normalization module
norm_path = hf_hub_download(repo_id, "badini_normalize.py")
spec = importlib.util.spec_from_file_location("badini_normalize", norm_path)
badini_normalize = importlib.util.module_from_spec(spec)
spec.loader.exec_module(badini_normalize)

processor = Wav2Vec2BertProcessor.from_pretrained(repo_id)
model = Wav2Vec2BertForCTC.from_pretrained(repo_id).eval()

speech, sr = sf.read("audio.wav")   # 16 kHz mono
inputs = processor(speech, sampling_rate=16000, return_tensors="pt")
with torch.no_grad():
    logits = model(**inputs).logits
pred_ids = torch.argmax(logits, dim=-1)
raw_text = processor.batch_decode(pred_ids)[0]

# apply the normalization pipeline (punctuation handling, Badini number
# expansion, character/word-variant unification)
text = badini_normalize.normalize_transcript(raw_text)
print(text)
```

## Intended use

Speech transcription for Badini Kurdish, with the recommended normalization
already applied by following the usage example above.