README.md

---
language:
- am
tags:
- mms
- meta
- kenlm
- amharic
- automatic-speech-recognition
license: cc-by-nc-4.0
pipeline_tag: automatic-speech-recognition
---

## Model Summary
Well I made a KenLM model that works with Meta's <a href="https://huggingface.co/facebook/mms-1b-all">Massively Multilingual Speech (MMS)</a> to improve ASR transcriptions in the Amharic language.
The model is based on the Amharic Common Crawl corpus dating from Jan-Dec of 2018 (<a href="https://data.statmt.org/cc-100/">link</a>). It seems to improve my ASR transcriptions considerably well,
but of course I don't expect this LM to improve the WER for amharic transcriptions to the level spoken of in the MMS paper (around 32%). To do that, a larger Amharic corpus would be needed, and I have 
no clue how to compile one myself. For reference, the one I used is merely 837MB; the 
<a href="https://scontent.fphx1-2.fna.fbcdn.net/v/t39.8562-6/348827959_6967534189927933_6819186233244071998_n.pdf?_nc_cat=104&ccb=1-7&_nc_sid=ad8a9d&_nc_ohc=APrxV5RqnpwAX_XU5Kf&_nc_ht=scontent.fphx1-2.fna&oh=00_AfDOEKZa4CJrwLrCdt4RwjMVJUCO6Fe3XmpEtjKxtRwUpg&oe=649BD6C2">MMS paper</a> suggests using a corpus of > 5GB. <br />

## Getting Started
To use this LM-boosted processor via the Transformers library, utilize the "Wav2Vec2ProcessorWithLM" class instead of "Wav2Vec2Processor". Here's a quick example of how I use it: <br />
```py
from transformers import Wav2Vec2ForCTC, Wav2Vec2ProcessorWithLM


# load pretrained model
model = Wav2Vec2ForCTC.from_pretrained("facebook/mms-1b-all")
processor = Wav2Vec2ProcessorWithLM.from_pretrained("jlonsako/mms-1b-all-AmhLM")

model.load_adapter("amh")

input_values = processor("insert audio file path", sampling_rate=16_000, return_tensors="pt").input_values

with torch.no_grad():
  logits = model(input_values).logits
transcription = processor.batch_decode(logits.numpy()).text
print(transcription[0])
```

## Limitations
I would love to post stats like WER and BLEU scores on out-of-framework datasets, but considering the fact that I'm a C# web developer by trade,
 I have no clue how to perform those tests. I just want to make this available for anyone who wants to test MMS performance with an AMH LM,
  and also for my own use. Happy testing!


## Final Notes
I hope it goes without saying that this repository inherits licenses from Meta MMS, meaning this repo can only be used for research purposes. 
Personally, I am using this to build a simple video transcription app for Amharic videos generated by my church. If you wanna know more or would like 
to help make this LM better (seeing as I am clueless), feel free to reach out to me at my email: [email protected]. <br />
-Joshua Lonsako