# Nigerian Language Translator API (English to Hausa, Yoruba, Igbo)
This is a RESTful API service that translates English text to Nigerian languages — **Hausa**, **Yoruba**, and **Igbo** — using pretrained machine learning models. The API can be tested via tools like **Postman** or integrated into applications.
---
## 🔧 Project Setup
1. Clone the repository:
git clone
github.com
cd eng2na-translate-api
Install required dependencies:
pip install -r requirements.txt
Run the API:
python app.py
🚀 API Endpoints
✅ POST /translate
Translate English to Hausa, Yoruba, or Igbo.
📥 Request Body (JSON)
{
"text": "How are you?",
"target_language": "hausa"
}
Supported target_language values:
hausa
yoruba
igbo
📤 Response (JSON)
{
"original_text": "How are you?",
"translated_text": "Lafiya lau",
"language": "hausa"
}
🧠 Model Info
Pretrained Transformer models (e.g., Google Translator)
Fast inference using HuggingFace Transformers or ONNX (depending on deployment)
🧪 Testing with Postman
Open Postman.
Set method to POST.
URL:
localhost
Headers: Content-Type: application/json
Body:
{
"text": "Good morning",
"target_language": "yoruba"
}
Author
Mohammed Musa Jidda
Feel free to contribute or raise issues.