Preciousuwadone/Linguix-ng

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 …