Skip to content

tejask011/disease-outbreak

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

27 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🌍 AegisEpi

A high-fidelity, production-grade disease monitoring and risk prediction platform.
This system leverages Machine Learning to analyze historical outbreak data, weather patterns, and real-time reports to provide actionable insights for public health officials and the general public.

Unlike traditional systems, it focuses on detecting early weak signals β€” identifying outbreaks before they become obvious.


πŸ“± Mobile Implementation (Screenshots)

πŸ“Š Dashboard & Map

Dashboard Risk Map
Dashboard Risk Map

πŸ“ˆ Analytics & Trends

Analytics
Analytics

❗ Problem Statement

Most current outbreak detection systems:

  • Reactive, not Proactive: Depend on confirmed hospital data which is often delayed.
  • Late Detection: Outbreaks are identified only after significant community spread.
  • Data Silos: Lack of integration between environmental factors and clinical data.

πŸ‘‰ This platform bridges the gap by detecting early signals before they escalate into crises.


πŸ’‘ Our Approach

Instead of waiting for large spikes, the system analyzes "Silent Signals":

  • Micro-Trends: Gradual increases in symptoms or cases over 7–14 days.
  • Environmental Context: Real-time integration of humidity, rainfall, and temperature data.
  • Pattern Recognition: Regional disease patterns compared against historical baselines.

βš™οΈ Key Features

1️⃣ Real-time Risk Engine

  • AI-powered predictions using Random Forest and Gradient Boosting models.
  • Dynamic risk scoring (Low / Medium / High) updated as new data flows in.
  • Explainable risk factors (Weather + Growth + Volume).

2️⃣ Geographic Intelligence

  • Interactive maps with outbreak clusters and hyperlocal risk detection.
  • Seamless navigation between global, regional, and area-specific data.

3️⃣ Advanced Analytics

  • Time-series tracking for multiple pathogens (Dengue, Malaria, Flu, etc.).
  • Comparative analysis of current trends against historical seasonal averages.

4️⃣ Data Management

  • Secure CSV / Excel upload support for rapid data ingestion.
  • Automated cleaning and normalization of clinical reports.

🧠 Core Concept

"Detecting the invisible before it becomes inevitable."


πŸ›  Technology Stack

πŸ“± Frontend (Mobile)

  • Framework: React Native (Expo)
  • UI/UX: Premium Glassmorphic Design System
  • Visualization: react-native-chart-kit, react-native-svg
  • Mapping: react-native-maps

🌐 Web Dashboard

  • Framework: React.js (Vite)
  • Charts: Chart.js / Recharts
  • Styling: Tailwind CSS / Modern CSS Variables

βš™οΈ Backend & API

  • Runtime: Node.js / Express.js
  • Database: MongoDB (Atlas)
  • Architecture: RESTful API with automated geocoding services.

🧠 Machine Learning

  • Language: Python
  • Library: Scikit-learn
  • Models: Random Forest Regressor, Gradient Boosting
  • Serving: Flask / FastAPI microservice

🌍 External Services

  • Weather Data: OpenWeather / WeatherStack API
  • Geocoding: OpenCage / Nominatim API

βš™οΈ System Flow

graph TD
    A[Clinical Data + Reports] --> B[Processing & Cleaning]
    C[Weather & Env Data] --> B
    B --> D[Trend Analysis last 30 Days]
    D --> E[Weak Signal Detection]
    E --> F[ML Risk Engine]
    F --> G[Insight Generation]
    G --> H[Visualization & Alerts]
Loading

πŸ“ Project Structure

β”œβ”€β”€ Backend/           # Express server, API controllers, and DB services
β”œβ”€β”€ mobile-app/        # React Native source code (iOS/Android)
β”œβ”€β”€ ml/               # Python ML models and prediction engine
β”œβ”€β”€ frontend/          # React.js web dashboard
└── screenshots/       # Visual documentation of the implementation

πŸš€ Getting Started

1. Backend Setup

cd Backend
npm install
npm start

2. Mobile App Setup

cd mobile-app
npm install
npx expo start

3. ML Service Setup

cd ml
pip install -r requirements.txt
python server.py

πŸ‘₯ The Team and contribution

  • **Tejas Kulkarni-- -CSV Upload & Validation -Data Preprocessing & Cleaning -Input Handling & Error Checking -UI for Data Handling - Deployment and database handling

  • **Yashashri Rajput-- - Environment Data Integration - API Development & Integration - UI for Data Visualization

  • **Samruddhi Patil-- - Risk Calculation Logic - Outbreak Prediction & Scoring - UI for Analytics & Insights


πŸ’‘ Future Roadmap

  • Real-time Integration: Direct hooks into hospital management systems.
  • Push Alerts: Geofenced notifications for high-risk zones.
  • Deep Learning: Implementing LSTM models for better time-series forecasting.
  • Multi-Agent AI: Specialized agents for pandemic simulation.

Developed as part of the AI-Based Disease Outbreak Prediction System Project.

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • JavaScript 95.4%
  • CSS 2.8%
  • Python 1.4%
  • HTML 0.4%