Instructions to use Okejonah1/obolo-ai-translation with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use Okejonah1/obolo-ai-translation 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="Okejonah1/obolo-ai-translation")# Load model directly from transformers import AutoTokenizer, AutoModelForSeq2SeqLM tokenizer = AutoTokenizer.from_pretrained("Okejonah1/obolo-ai-translation") model = AutoModelForSeq2SeqLM.from_pretrained("Okejonah1/obolo-ai-translation", device_map="auto") - Notebooks
- Google Colab
- Kaggle
Obolo AI Translation System
About This Project
This is an AI-powered translation tool for English to Obolo, built to support the important work of Obolo language preservation and translation.
Important Note: This is a technology demonstration and AI tool. The authoritative Obolo translations come from OLBTO (Obolo Language and Bible Translation Organization), the recognized experts in Obolo language and Bible translation.
My Role: I am an AI technology enthusiast bringing machine learning capabilities to support Obolo language visibility in the AI age.
Author
Okejonah1 (Oke Nteigbanam J.)
Acknowledgments
OLBTO (Obolo Language and Bible Translation Organization)
The recognized authority on Obolo Bible translation and language preservation.
Obolo Linguists and Researchers
The dedicated linguists who documented Obolo grammar rules, vocabulary, and language structures.
The Obolo Community
The speakers, elders, and community members who preserve the Obolo language.
Meta (M2M-100)
For providing the multilingual translation model.
How Their Work Was Used
| Contribution | Source | How Used |
|---|---|---|
| Bible Translations | OLBTO | 31,104 training pairs |
| Dictionary | Linguists and Researchers | 6,383 training pairs |
| Grammar Rules | Linguists and Researchers | 35 rules integrated |
| Language Data | Wikipedia and Community | Additional training data |
Dictionary Examples (English to Obolo)
| English | Obolo |
|---|---|
| God | Awaji |
| father | Nte |
| world | isonyọn̄ |
| earth | linyọn̄ |
| light | utoon̄ |
| life | ugwem |
| day | usen |
| thank you | oniro |
| please | soso |
| spirit | Ekwukwu |
| kingdom | ido |
| name | erieen |
Bible Translation Examples (English to Obolo)
| English Bible Verse | Obolo Translation |
|---|---|
| In the beginning God created the heaven and the earth. | Me ibebene, Awaji îrom isinyọn̄ mè linyọn̄. |
| The Lord is my shepherd; I shall not want. | Okumugwem re ogwu ịkpụkpụo ugwem n̄a; mi inyịma mba dọgọ. |
What This Tool Does
- AI Translation Model: Fine-tuned M2M-100 with 418M parameters trained on 40k pairs
- Dictionary Lookup: 6,383+ Obolo words with variants
- Hybrid System: Dictionary first, AI fallback for unknowns
- Meaning-Based: Cultural adaptations and natural Obolo phrasing
How to Use
from transformers import M2M100ForConditionalGeneration, M2M100Tokenizer
import json
model = M2M100ForConditionalGeneration.from_pretrained("Okejonah1/obolo-ai-translation")
tokenizer = M2M100Tokenizer.from_pretrained("Okejonah1/obolo-ai-translation")
# Load dictionary
with open("obolo_dictionary_master.json", "r") as f:
dictionary = json.load(f)
def translate(text):
# 1. Check dictionary first
text_lower = text.lower().strip()
if text_lower in dictionary:
return dictionary[text_lower]
# 2. Use AI model
tokenizer.src_lang = "en"
inputs = tokenizer(text, return_tensors="pt", truncation=True, max_length=128)
outputs = model.generate(**inputs, max_length=128, num_beams=5)
return tokenizer.decode(outputs[0], skip_special_tokens=True)
print(translate("God")) # Awaji
print(translate("thank you")) # oniro
print(translate("please")) # soso
Model Details
- Base Model: facebook/m2m100_418M
- Training Data: 40,000+ English-Obolo pairs
- Training Steps: 14,250
- Final Validation Loss: 0.82
- Format: safetensors
Features
- AI-assisted translation
- Dictionary lookup for known words
- Multiple variants support
- Cultural adaptation awareness
Limitations
- This is an AI tool, not an expert translator
- Always verify translations with native speakers
- OLBTO and expert translations remain the authoritative source
License
MIT License
Author
Okejonah1 (Oke Nteigbanam J.)
Contact
- Hugging Face: Okejonah1
- GitHub: Okejonah1
Thank You
To all who have worked to preserve and promote the Obolo language: Your work is the foundation upon which this AI tool is built. This project exists because of your dedication to the Obolo language.
- Downloads last month
- 46