samueladdis/Milk-Mastery-Bot

Educational Telegram bot for Ethiopian dairy farmers - Precision Development ET # Milk Mastery Bot An educational Telegram chatbot designed to empower Ethiopian dairy farmers with practical milk production knowledge through interactive, story-driven learning modules. ## Features - **Multilingual Support**: English, Amharic (አማርኛ), Tigrigna (ትግርኛ), and Oromo (Afaan Oromoo) - **User Registration**: Validates name and Ethiopian phone numbers - **Storytelling Approach**: Follow Abebe's journey through dairy farming education - **Interactive Learning**: Multimedia content with images and YouTube videos - **Progress Tracking**: Sequential section unlocking based on completion - **Quiz System**: Multiple question types (True/False, MCQ, text input) - **Community Integration**: Telegram group for collaborative activities - **Data Persistence**: JSON-based user data storage with automatic backups ## Learning Modules ### Module 1: Observing Purposefully (Active) Learn systematic cow observation techniques through 10 progressive sections: - Section 1: Observing Purposefully - Section 2: From Large to Small - Section 3: Evaluating the Herd - Section 4: Evaluating the Individual Animal - Sections 5-10: Advanced observation techniques ### Modules 2-6 (Coming Soon) - Module 2: On Pasture - Module 3: Confined Housing - Module 4: While Eating And Digesting - Module 5: The Milking Parlour - Module 6: Heifers and Dry Cows ## Quick Start ### Prerequisites - Python 3.9 or higher - Telegram Bot Token (get from @BotFather) ### Installation 1. **Clone the repository** (or navigate to the project directory): ```bash cd milk-mastery-bot ``` 2. **Install dependencies**: ```bash pip install -r requirements.txt ``` 3. **Set up environment variables**: ```bash cp .env.example .env ``` Edit `.env` file and add your Telegram bot token: ``` TELEGRAM_BOT_TOKEN=your_actual_bot_token_here ``` 4. **Run the bot**: ```bash python milk_mastery_bot_complete.py ``` ## Project Structure ``` milk-mastery-bot/ ├── milk_mastery_bot_complete.py # Main bot application ├── lan …