Instructions to use Ijwi-ry-Ikirundi-AI/nllb-kirundi-multi with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use Ijwi-ry-Ikirundi-AI/nllb-kirundi-multi with Transformers:
# Use a pipeline as a high-level helper # Warning: Pipeline type "translation" is no longer supported in transformers v5. # You must load the model directly (see below) or downgrade to v4.x with: # 'pip install "transformers<5.0.0' from transformers import pipeline pipe = pipeline("translation", model="Ijwi-ry-Ikirundi-AI/nllb-kirundi-multi")# Load model directly from transformers import AutoTokenizer, AutoModelForSeq2SeqLM tokenizer = AutoTokenizer.from_pretrained("Ijwi-ry-Ikirundi-AI/nllb-kirundi-multi") model = AutoModelForSeq2SeqLM.from_pretrained("Ijwi-ry-Ikirundi-AI/nllb-kirundi-multi", device_map="auto") - Notebooks
- Google Colab
- Kaggle
license: apache-2.0
datasets:
- Ijwi-ry-Ikirundi-AI/Kirundi_Open_Speech_Dataset
language:
- rn
- fr
- en
metrics:
- bleu
base_model:
- facebook/nllb-200-distilled-600M
pipeline_tag: translation
library_name: transformers
tags:
- nllb
- fine-tuned
- kirundi
- multilingual
- umuseke-w-ijwi
- ijwi-ry-ikirundi
- burundi
model-index:
- name: nllb-kirundi-multi
results:
- task:
type: translation
dataset:
name: Kirundi Open Speech Dataset
type: Ijwi-ry-Ikirundi-AI/Kirundi_Open_Speech_Dataset
metrics:
- name: BLEU
type: bleu
value: 9.94
nllb-kirundi-multi (Umuseke w'Ijwi) ๐ง๐ฎ
Ikirundi cacu, Ijwi ryacu!
(Our language, our voice!)
Fine-tuned NLLB-200-600M model for multidirectional translation.
Part of the Umuseke w'Ijwi initiative for African Linguistic Sovereignty.
๐ Vision
Our mission is to bridge the "Digital Linguistic Divide" for the 30 million Kirundi speakers in East Africa. By creating open-source AI infrastructure, we ensure that Kirundi is a first-class citizen in the global digital revolution.
This model serves as a foundational "engine" for:
- ๐๏ธ Speech-to-Text (ASR)
- ๐ฃ๏ธ Text-to-Speech (TTS)
- ๐ Machine Translation (MT)
๐ Key Features
This is a multidirectional translation model (Seq2Seq) capable of translating:
- Kirundi (run_Latn) โ French (fra_Latn)
- Kirundi (run_Latn) โ English (eng_Latn)
๐ Training & Performance
- Base Model: Meta NLLB-200-distilled-600M.
- Dataset: Kirundi Open Speech Dataset (approx. 11k pairs in this version).
- Current Score: 9.94 BLEU (Iteration V1). Performance is expected to increase as the community adds more validated "Gold" phrases.
๐ ๏ธ Usage (Python)
from transformers import AutoTokenizer, AutoModelForSeq2SeqLM
tokenizer = AutoTokenizer.from_pretrained("Ijwi-ry-Ikirundi-AI/nllb-kirundi-multi")
model = AutoModelForSeq2SeqLM.from_pretrained("Ijwi-ry-Ikirundi-AI/nllb-kirundi-multi")
# Example: Kirundi -> French
tokenizer.src_lang = "run_Latn"
text = "Amahoro y'Imana abane nawe."
inputs = tokenizer(text, return_tensors="pt")
output = model.generate(
**inputs,
forced_bos_token_id=tokenizer.convert_tokens_to_ids("fra_Latn")
)
print(tokenizer.decode(output[0], skip_special_tokens=True))
๐ซฑ๐ฝโ๐ซฒ๐ป Community & Open Source
This project is dedicated to the Open Source community. We believe that linguistic data and AI models should be public goods to foster innovation and inclusion across Africa.
๐ฅ Contributors
- Samandari: github.com/Sama-ndari
- Rugwe: github.com/Irumva17
Built by Ijwi ry'Ikirundi AI.