hirwablessing/blessing_hirwa_rl_summative

AI literacy tutor for African education, addressing linguistic and literacy barriers across four languages: Kinyarwanda, Swahili, Yoruba, and Amharic # African Literacy AI Tutor - RL Summative ## Mission Tackling linguistic and literacy barriers in African education by developing voice-first, localized AI tutoring systems using reinforcement learning. ## Environment: AfricanLiteracyTutor-v0 A custom Gymnasium environment where an RL agent acts as an AI tutor, making pedagogical decisions to teach a simulated student literacy skills across four African languages: **Kinyarwanda**, **Swahili**, **Yoruba**, and **Amharic**. ### Observation Space (23 dimensions) - **Mastery Skills** (6): phoneme, letter recognition, syllable formation, word reading, sentence comprehension, vocabulary - **Affective States** (4): engagement, fatigue, frustration, confidence - **Performance Metrics** (3): recent accuracy, response latency, streak - **Error Patterns** (3): phoneme errors, tone errors, grammar errors - **Session Variables** (7): progress, language, L1 transfer, spaced repetition, difficulty, review timing, lesson type ### Action Space (15 discrete actions) | ID | Action | Description | |----|--------|-------------| | 0 | PHONEME_DRILL | Practice sound recognition | | 1 | LETTER_TRACING | Visual letter tracing | | 2 | SYLLABLE_BLENDING | Combine phonemes into syllables | | 3 | WORD_BUILDING | Construct words from syllables | | 4 | READ_ALOUD_WORD | Voice-based word reading | | 5 | SENTENCE_READING | Sentence comprehension | | 6 | VOCABULARY_INTRO | Introduce new vocabulary | | 7 | VOCABULARY_REVIEW | Spaced repetition review | | 8 | STORY_LISTENING | Listen to a story | | 9 | CALL_AND_RESPONSE | Interactive engagement game | | 10 | SWITCH_LANGUAGE | Switch target language | | 11 | INCREASE_DIFFICULTY | Raise difficulty level | | 12 | DECREASE_DIFFICULTY | Lower difficulty level | | 13 | GIVE_ENCOURAGEMENT | Verbal praise | | 14 | TAKE_BREAK | Rest period | ### Reward Structure - Primary: mastery improvement (+10x weight) - Engagement maintenance, spaced repetition timing, streak bonuses - Penalties: frustration, fatig …