rony-mandal/humaitarian-aid-distribution

# Humanitarian AI Crisis Management System ## 🎯 Project Overview An advanced **Multi-Agent AI System** for optimizing aid distribution in refugee settlements during humanitarian crises. This system uses multiple specialized AI agents powered by **local LLMs (Ollama)** to make intelligent decisions about resource allocation, logistics planning, and delivery optimization. ### 🌟 Key Features - **Multi-Agent Architecture**: Four specialized AI agents working collaboratively - **Local AI Processing**: Uses free, open-source Ollama (no API costs!) - **Real-time Decision Making**: Intelligent prioritization and resource optimization - **Route Optimization**: Efficient delivery planning with real-world constraints - **Adaptive Learning**: Continuous monitoring and improvement recommendations - **Interactive Visualizations**: Beautiful dashboards and analytics - **Privacy-First**: All data processing happens locally on your machine ### 🎬 Demo Results Typical single-cycle results: - ✅ **85-95% Success Rate** in aid delivery - 📊 **60-70% Population Coverage** per cycle - 🚚 **Optimized Routes** reducing delivery time by 30% - 🎯 **Critical Zone Prioritization** ensuring urgent needs met first --- ## 📋 Table of Contents 1. Prerequisites 2. Installation Guide 3. Quick Start 4. Detailed Usage 5. Viewing Results 6. Configuration 7. Troubleshooting 8. Project Structure --- ## 🔧 Prerequisites ### System Requirements - **Operating System**: macOS, Linux, or Windows - **Python**: Version 3.9 - 3.13 (Python 3.14 has some warnings but works) - **RAM**: Minimum 8GB (16GB recommended for larger models) - **Disk Space**: At least 5GB free (for Ollama and models) - **Internet**: Required only for initial setup ### Software Dependencies - Python 3.9+ - pip (Python package manager) - Ollama (for local AI inference) - Web browser (Chrome, Firefox, or Safari) --- ## 🚀 Installation Guide ### Step 1: Install Ollama Ollama provides free, local AI models. Choose your platform: ### …