Poutrivet/Poultrivet

🛰️ AI-powered poultry disease early warning system combining satellite imagery (Sentinel-2, MODIS) with YOLOv8 deep learning for smallholder farmers across Uganda. Live API deployed at poulivetapi.onrender.com # 🛰️ PoultriVet — Poultry Disease Early Warning System **An integrated satellite imagery and deep learning system for proactive poultry disease risk prediction serving 4.2 million smallholder farmers across Uganda.** 🌐 Live API · 📖 API Docs · 📊 Risk Summary --- ## 🌍 The Problem Uganda's 4.2 million smallholder poultry farmers lose over **UGX 350 billion annually** to preventable disease outbreaks. 73% of poultry mortality occurs with **zero prior warning**, and 61% of farmers are more than 20km from the nearest veterinary officer. ## 💡 The Solution PoultriVet combines two powerful technologies into one system: | Component | Technology | What It Does | |-----------|-----------|--------------| | 🛰️ Satellite Risk Mapping | Sentinel-2, MODIS, GEE | Weekly environmental risk scores for 164 Uganda districts | | 🔬 Disease Detection | YOLOv8 Deep Learning | AI diagnosis from poultry dropping photos | | 📡 Backend API | FastAPI + Render | Permanent REST API serving all data | | 📱 Mobile App | Flutter + Dart | Android app for farmers | --- ## 🏗️ System Architecture Sentinel-2 (ESA) ──┐ MODIS (NASA) ──┤──► Google Earth Engine ──► Risk Scoring ──► FastAPI ──► Flutter App JRC Water Data ──┘ YOLOv8 ──► --- ## 🚀 Live API Base URL: `poulivetapi.onrender.com` | Endpoint | Method | Description | |----------|--------|-------------| | `/` | GET | API status and endpoint directory | | `/summary` | GET | National risk summary — 164 districts | | `/risk-map` | GET | Full district-level satellite risk data | | `/district/{name}` | GET | Single district risk lookup | | `/analyse-dropping` | POST | YOLOv8 disease detection from image | **Quick test — open in your browser:** poulivetapi.onrender.com --- ## 🛰️ Satellite Pipeline Environmental indicators extracted weekly for all 164 Uganda districts: - **NDVI** — Vegetation density (Sentinel-2 B8/B4) → Newcastle Disease risk - **NDMI** — Mo …