This project aims to build a machine translation system and digital dataset for the **Igede language** spoken in Benue State, Nigeria. It's designed to support language preservation, data accessibility, and AI/ML-based translation.
# 🗣️ Igede Language Translation Project
This project aims to build a machine translation system and digital dataset for the **Igede language** spoken in Benue State, Nigeria. It's designed to support language preservation, data accessibility, and AI/ML-based translation.
## 📂 Project Structure
- `scripts/`: Web scrapers and data cleaning tools.
- `data/raw/`: Unprocessed files from Glosbe, Bible, dictionaries.
- `data/cleaned/`: Sentence-aligned translation pairs.
- `notebooks/`: Exploration, cleaning, and visualizations.
- `models/`: Any trained model artifacts.
- `app/`: Frontend/backend code (e.g., Streamlit demo).
## Project Structure:
igede_translate_project/
│
├── data/
│ ├── raw/ # Unprocessed data (scraped text, raw Bible texts, dictionaries)
│ └── cleaned/ # Cleaned, normalized, aligned sentence pairs for training
│
├── notebooks/ # Jupyter/Colab notebooks for prototyping and EDA
│ └── exploratory.ipynb
│
├── scripts/ # Python scripts for automation (scraping, cleaning, aligning)
│ ├── scrape_glosbe.py
│ ├── align_bible.py
│ └── clean_data.py
│
├── models/ # NMT model files, checkpoints, tokenizer config
│ └── igede_en_model/
│
├── app/ # App backend or frontend (e.g., Flask, Streamlit)
│ └── translator_app.py
│
├── requirements.txt # List of Python dependencies (requests, pandas, etc.)
├── README.md # Project overview, goals, usage instructions
└── .gitignore # To ignore cache, virtualenvs, or large files
## ✅ Getting Started
1. Install dependencies:
```bash
pip install -r requirements.txt