Gentwocoder/HNG-STAGE3

An intelligent AI agent specialized in answering questions about Yoruba history and culture. # Orunmila - Yoruba History & Culture AI Agent **Orunmila** is an intelligent AI agent specialized in answering questions about Yoruba history and culture. Named after the Yoruba deity of wisdom and divination, this agent provides accurate, culturally sensitive information about Yoruba heritage, integrated seamlessly with Telex.im messaging platform. ## 🌟 Features - **AI-Powered Knowledge Base**: Comprehensive understanding of Yoruba history, culture, religion, language, arts, and traditions - **Telex.im Integration**: Real-time webhook support for instant messaging responses - **REST API**: Clean, well-documented API for direct interaction - **Robust Error Handling**: Proper validation and error responses - **Background Processing**: Efficient message handling with async processing - **Extensible Architecture**: Modular design for easy customization ## 📋 What the Agent Knows ### History - Origins of the Yoruba people - Ancient kingdoms (Oyo, Ife, Benin connections) - Historical migrations and settlements - Colonial era and independence - Modern Yoruba states in Nigeria ### Culture - Traditional practices and customs - Family structures and chieftaincy systems - Naming ceremonies (Isomoloruko) - Weddings (Igbeyawo) and funerals - Social etiquette and values ### Religion - Ifa divination system - Orisha worship (Sango, Oya, Osun, Obatala, etc.) - Ancestor veneration - Integration with Christianity and Islam ### Language - Yoruba language structure - Proverbs (Owe) and sayings - Greetings and common phrases - Tonal system and pronunciation ### Arts & Music - Gelede masks and Egungun masquerades - Bronze and terracotta works - Aso-Oke weaving and Adire cloth - Traditional music and dance - Talking drums (Dundun, Gangan, Bata) ### Festivals - Olojo Festival - Osun-Osogbo Festival - Eyo Festival - Other cultural celebrations ## 🚀 Quick Start ### Prerequisites - Python 3.11 or higher - OpenAI API key - Telex.im account and API credentials (optional for we …