Preciousuwadone/Linguix-ng
Domain:
natural language processingRecord type:
modelsoftware
Creator:
Pre
Host:
Linguix NG is a domain-specific bidirectional translation system that bridges the communication gap between Nigerian Pidgin (Naija) speakers and English-based service providers in Healthcare, Banking, Retail, and Customer Service.
# Linguix NG
**Enhancing Digital Inclusion through a Bidirectional Neural Machine Translation Framework for Nigerian Pidgin (Naija)**
---
### 🎯 Project Overview
Linguix NG is a **domain-specific bidirectional translation system** that bridges the communication gap between Nigerian Pidgin (Naija) speakers and English-based service providers in **Healthcare, Banking, Retail, and Customer Service**.
It enables seamless real-time conversation:
- Naija-speaking users can communicate in their natural language.
- English-speaking institutions receive accurate, formal English translations.
**Final BLEU Score: 74.76** : A strong result for a low-resource language with only ~8,000 training pairs.
---
### ✨ Key Features
- **Bidirectional Translation** (English ↔ Naija)
- **Domain-Aware** (Healthcare, Banking, Retail, Customer Service)
- **High-Quality Fine-Tuned Model** (Helsinki-NLP/opus-mt base)
- **RESTful Flask API** with hybrid fallback (MarianMT + Groq LLaMA)
- **Clean React Frontend** (ready for integration)
- **Translation History & Logging**
- **Production-ready folder structure**
---
### 🛠️ Tech Stack
| Layer | Technology |
|------------------|-----------------------------------------|
| **Model** | Hugging Face Transformers + MarianMT |
| **Backend** | Flask + Flask-CORS |
| **Frontend** | React.js + Vite |
| **Database** | SQLite (via Flask-SQLAlchemy) |
| **Training** | PyTorch, Google Colab (T4 GPU) |
| **Evaluation** | sacrebleu |
| **Deployment** | Render / Railway (planned) |
---
### 📁 Project Structure
```bash
linguix-ng/
├── backend/ # Flask REST API
├── frontend/ # React.js UI
├── model/
│ └── final_model/ # Trained model (BLEU 74.76)
├── corpus/
│ ├── processed/
│ └── Linguix_NG_Corpus_*.xlsx
├── notebooks/
│ └── trai …