English–Okun Translator for Kabba/Bunu Primary Schools is a Streamlit educational app that helps learners translate English to Okun, learn a Word of the Day, practice through Daily Challenges, and track their learning progress with achievements and accuracy metrics.
# english-to-okun-kabba-bunu-
English–Okun Translator for Kabba/Bunu Primary Schools is a Streamlit educational app that helps learners translate English to Okun, learn a Word of the Day, practice through Daily Challenges, and track their learning progress with achievements and accuracy metrics.
# English–Okun Translator (Kabba/Bunu Primary Schools)
An educational **Streamlit** app that helps learners translate **English → Okun**, learn a **Word of the Day**, practice with **Daily Challenges**, and track **progress**.
## Features
- **Translate** English words/short phrases into Okun
- **Word of the Day** (deterministic daily selection)
- **Daily Challenge** (guess the correct Okun translation)
- **Progress tracking**
- Words practiced
- Challenges attempted
- Challenge accuracy
- **Achievements & goal**
- Goal: 100 words practiced
- **Reset progress** button
- Styled, responsive UI for mobile and desktop
---
## Screenshot / UI Notes (optional)
Add screenshots here if you want.
---
## How It Works (Simple Explanation)
1. The app loads a vocabulary dataset from `okun_vocab.csv`.
2. When a learner translates text:
- Known words are replaced with their Okun equivalents
- Unknown words are shown in brackets, e.g. `[someword]`
3. Word of the Day uses today’s date to pick a vocabulary row consistently.
4. Daily Challenge selects a random vocabulary row and checks the user answer.
5. Learner progress is stored using `st.session_state` (resets when the session ends unless you later add persistence).
---
## Project Structure
```text
.
├── app.py
├── okun_vocab.csv
├── requirements.txt
├── README.md
└── .gitignore