Skip to content

BhaveshV23/RouteMindAI

Repository files navigation

🚚 RouteMindAI: Predictive Logistics & Delay Risk Analyzer

Built for Hack2Skill Solution Challenge 2026 – Build with AI Track

Flutter Firebase Google Gemini

RouteMindAI is an AI-powered predictive logistics intelligence platform that helps fleet managers anticipate delivery delays before dispatch, instead of reacting after disruptions occur. By combining route geometry, micro-weather sampling, and Google Gemini 2.5 Flash reasoning, the system generates interpretable delay-risk predictions and recommends actionable alternatives.

This project demonstrates how Generative AI + Geospatial APIs + Weather Intelligence can transform traditional logistics workflows into proactive, data-driven planning systems.


🌐 Live Project Links

Resource Link
🚀 Live Web App View Live App
🎥 Demo Video Watch on Google Drive
📊 Pitch Deck View Slides
📦 GitHub Repository View Source Code

📸 Application Screenshots

1️⃣ Route Prediction Input Screen

Route Input Screen

Users enter shipment source and destination cities.

This triggers:

  • route geometry extraction
  • weather sampling along the corridor
  • Gemini-based delay risk prediction pipeline

2️⃣ AI Delay Risk Prediction Dashboard

Prediction Dashboard

Displays AI-generated logistics insights:

Includes:

  • Risk classification (Low / Medium / High)
  • Delay probability percentage
  • Weather-based explanation
  • Suggested alternate routing strategy

3️⃣ Route Analytics Intelligence Panel

Analytics Dashboard

Provides enterprise-style analytics such as:

  • Average delay probability
  • Most common disruption type
  • High-risk corridor frequency tracking

Helps organizations identify long-term disruption hotspots.


4️⃣ Route Visualization Map

Route Map Visualization

Interactive map view displays:

  • shipment origin
  • destination
  • geographic corridor overview

Supports spatial understanding of predicted risk zones.


📌 Problem Statement

Modern logistics operations still depend heavily on reactive planning.

Fleet operators typically:

  • dispatch shipments based on static route estimates
  • rely on incomplete weather insights
  • detect risks only after vehicles are already in transit
  • suffer delays, fuel losses, and supply-chain disruption

This leads to:

❌ missed delivery windows

❌ increased operational costs

❌ poor customer experience

❌ inefficient route planning decisions


💡 Our Solution

RouteMindAI introduces an AI-driven predictive route-risk intelligence system that:

✅ samples weather conditions along the actual shipment corridor

✅ evaluates route geometry using geospatial APIs

✅ analyzes structured climate signals using Gemini 2.5 Flash

✅ generates interpretable risk probability scores

✅ recommends safer alternate logistics strategies

Instead of reacting to delays, logistics teams can now prevent them proactively.


🎯 Target Users

RouteMindAI is designed for:

  • Fleet managers
  • Supply chain analysts
  • Logistics startups
  • Transport aggregators
  • Warehouse dispatch coordinators
  • Enterprise logistics planning teams

✨ Core Features

1️⃣ Automated Route Geometry Extraction

The system automatically:

  • converts source & destination into coordinates
  • generates route polylines
  • extracts route nodes
  • samples geographic checkpoints along the corridor

Powered by:

OpenRouteService Directions API


2️⃣ Micro-Weather Corridor Sampling

Instead of city-level forecasts, RouteMindAI performs:

📍 node-level weather intelligence collection

Weather parameters sampled include:

  • rainfall probability
  • cloud coverage
  • storm intensity
  • humidity conditions

This produces route-specific climate intelligence, not generic forecasts.

Powered by:

OpenWeatherMap API


3️⃣ Gemini-Powered Delay Risk Prediction Engine

Structured weather + route data is converted into a JSON payload and analyzed using:

Google Gemini 2.5 Flash

Gemini produces:

  • delay probability percentage
  • risk classification (Low / Medium / High)
  • explanation of risk factors
  • corridor-level insights
  • alternate route suggestions

This transforms raw environmental signals into actionable logistics intelligence.


4️⃣ High-Risk Corridor Intelligence Dashboard

All predictions are stored inside:

Firebase Firestore

This enables:

📊 historical analytics

📊 route-risk trend tracking

📊 repeated delay corridor detection

📊 enterprise planning support

Organizations can identify long-term disruption hotspots.


🧠 AI Pipeline Architecture

Below is the intelligence pipeline used inside RouteMindAI:

User Input
   ↓
Geocoding (Source → Destination)
   ↓
Polyline Route Extraction
   ↓
Route Node Sampling
   ↓
Weather Sampling at Each Node
   ↓
Structured JSON Risk Payload
   ↓
Gemini 2.5 Flash Analysis
   ↓
Delay Probability + Explanation
   ↓
Firestore Storage
   ↓
Analytics Dashboard Visualization

🏗️ System Architecture Overview

Frontend

Flutter Web (Dart)

Chosen because:

  • single codebase supports mobile + web
  • fast UI rendering
  • scalable architecture

Backend Infrastructure

Firebase Platform

Includes:

  • Firebase Hosting
  • Cloud Firestore
  • Secure API integration

Benefits:

  • real-time sync
  • scalable architecture
  • zero-server deployment

AI Engine

Google Gemini 2.5 Flash

Used for:

  • structured reasoning
  • probability estimation
  • corridor-risk interpretation
  • alternate route suggestions

Gemini acts as a virtual logistics analyst.


External APIs Used

API Purpose
OpenRouteService Geocoding + Route Polyline
OpenWeatherMap Micro-weather intelligence
Gemini API Predictive reasoning engine

🔄 Data Flow Diagram (Conceptual)

User enters route
      ↓
OpenRouteService generates polyline
      ↓
System extracts sample nodes
      ↓
Weather fetched per node
      ↓
Structured JSON generated
      ↓
Gemini analyzes disruption probability
      ↓
Prediction saved in Firestore
      ↓
Dashboard displays insights

📊 Example Output Generated by RouteMindAI

Example prediction:

Route: Pune → Mumbai
Risk Level: HIGH
Delay Probability: 68%
Reason:
Heavy rainfall clusters detected near Lonavala corridor
Alternate Suggested:
NH160 corridor route recommended

This makes predictions interpretable and operationally useful.


🚀 Local Setup Guide

Follow these steps to run the project locally.

Step 1 — Clone Repository

git clone https://github.com/BhaveshV23/RouteMindAI.git
cd RouteMindAI

Step 2 — Install Dependencies

flutter pub get

Step 3 — Configure Environment Variables

Create a file named:

.env

Inside project root directory.

Add the following:

GEMINI_API_KEY=your_api_key
ORS_API_KEY=your_api_key
OPENWEATHER_API_KEY=your_api_key

⚠️ Keys are excluded intentionally for security reasons.


Step 4 — Run Application

Run on Chrome:

flutter run --dart-define-from-file=.env -d chrome

☁️ Deployment Architecture

RouteMindAI is deployed using:

Firebase Hosting

Deployment steps:

flutter build web
firebase deploy

🔐 Security Considerations

RouteMindAI follows best practices:

✅ API keys stored in .env

✅ keys excluded from GitHub

✅ Firebase-managed hosting

✅ structured JSON prompts for safe AI usage


📈 Future Improvements (Post-Hackathon Roadmap)

Upcoming enhancements planned:

  • traffic congestion prediction integration
  • historical delay ML training dataset
  • fleet-scale batch route evaluation
  • live vehicle tracking overlay
  • enterprise dashboard analytics
  • mobile application release

👨‍💻 Author

Bhavesh Vadnere

Information Technology Engineering Student

GitHub: https://github.com/BhaveshV23

Linkedin: https://linkedin.com/in/bhavesh-vadnere


⭐ Support the Project

If you found this useful:

⭐ Star the repository

🍴 Fork the project

📢 Share feedback

🤝 Collaborate on improvements


📜 License

This project is created for educational and hackathon demonstration purposes.

Production adaptation may require:

  • enterprise weather APIs
  • fleet telemetry integration
  • compliance alignment

🚀 RouteMindAI Vision

"From reactive logistics to predictive intelligence powered by AI."

About

RouteMindAI is an AI-powered predictive logistics platform that anticipates shipment delays before dispatch. It combines real-time route geometry, micro-weather sampling, and Google Gemini 2.5 Flash to generate actionable supply chain insights. Built for the Hack2Skill Solution Challenge 2026.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors