muhammad-luay/nutripulse

Nutrition intervention analysis and simulation platform for East African countries (Uganda and Kenya) # NutriPulse - Uganda Nutrition Intelligence Platform ## 🌍 Overview **NutriPulse** is a comprehensive nutrition intervention analysis and optimization platform designed to transform Uganda's nutrition landscape through data-driven decision making. The platform combines real-time analytics, predictive modeling, and supply chain optimization to guide high-impact nutrition investments. ### Key Impact Metrics - **Population Served**: 47.8 million Ugandans - **Children Under 5**: 7.2 million at-risk children - **Geographic Coverage**: 130 districts with granular data - **Current Stunting Rate**: 23.2% (targeting reduction to cd hackathon # Create virtual environment (recommended) python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate # Install dependencies pip install -r requirements.txt # Set up environment variables (optional, for SMS/email alerts) cp .env.example .env # Edit .env with your Twilio credentials if using SMS features # Launch the platform streamlit run uganda_nutrition_enhanced.py ``` ## 🎯 Usage Examples ### For Investors 1. Launch the dashboard and select "💼 Investor" role 2. Set investment amount (e.g., $5M USD) 3. Review ROI projections and risk assessments 4. Generate investment prospectus PDF ### For Policy Makers 1. Select "🏛️ Policy Maker" role 2. Upload district priority list or use defaults 3. Optimize budget allocation across interventions 4. Review coverage maps and equity analysis 5. Export implementation roadmap ### For Program Managers 1. Choose "🏥 Program Manager" role 2. Select target districts and populations 3. Design intervention mix based on local needs 4. Monitor real-time KPIs and supply chain status 5. Generate operational reports ### For Researchers 1. Select "📊 Researcher" role 2. Access raw data and statistical analyses 3. Run predictive models with custom parameters 4. Export publication-ready visualizations 5. Generate evid …