therealocean/MULUHUN

voice based email system for the visually impaired (HAUSA, IGBO, YORUBA) # 🎙️ MULUHUN ### Voice for Every Tongue **A voice-based email system for the visually impaired with indigenous Nigerian language support** **Yoruba · Hausa · Igbo · English** *Designed for the 4 million visually impaired Nigerians excluded from digital communication by English-centric, visual-heavy interfaces.* --- ## 📖 Table of Contents - Overview - Key Features - System Architecture - Tech Stack - AI Models - Voice Commands - Installation - Configuration - Running the System - API Reference - Project Structure - Roadmap - Attribution - Author --- ## Overview **MULUHUN** (derived from the word for *"voice"* across Yoruba, Hausa, and Igbo) is a full-stack web application that enables visually impaired Nigerians to compose, send, receive, and manage emails entirely through voice — in their mother tongue. The system bridges two critical barriers simultaneously: | Barrier | How MULUHUN Solves It | |---|---| | **Visual dependency** | Fully voice-driven UI — no reading required | | **English-only interfaces** | Complete support for Yoruba, Hausa, and Igbo | Users speak in their native language. The system transcribes using **language-specific Nigerian AI models**, translates to professional English, and sends the email — without the user needing to type a single character. Incoming emails are fetched, translated to the user's language, and read aloud automatically. The inbox announces unread counts, assigns a number to each email, and responds to spoken navigation commands in the user's language. --- ## Key Features - 🎙️ **Hands-free voice interface** — tap anywhere or press any key to activate the command mic - 🔊 **Automatic inbox announcement** — system reads unread count and email summaries aloud on load - 🔢 **Number-based navigation** — say "one" / "ọkan" / "ɗaya" / "otu" to open any email instantly - 🌐 **Three indigenous languages** — full Yoruba, Hausa, and Igbo support throughout - 📨 **Voice compose & send** — speak in your language, reci …