Skip to content
/ DeepFleet-AI Public template

DeepFleet-AI is an AI-powered fleet route optimization platform that combines machine learning, geolocation algorithms, and cloud infrastructure to enhance delivery efficiency and reduce operational costs. It offers a modular architecture with a FastAPI backend, Flask APIs, machine learning models, a React frontend (optional), and AWS integration

License

Notifications You must be signed in to change notification settings

hq969/DeepFleet-AI

Repository files navigation

DeepFleet-AI πŸššπŸ“¦

AI-Powered Logistics Fleet Optimization System

DeepFleet-AI is an end-to-end, production-grade fleet management and route optimization platform built using Machine Learning, AWS Cloud, and React. It enables intelligent delivery routing, ETA prediction, and real-time fleet visibility using historical delivery data and live tracking.


🌐 Tech Stack

🧠 Backend & ML

  • Python, Flask
  • Scikit-learn, Pandas, NumPy, XGBoost
  • Geopy, Haversine, Folium

🌍 Frontend (optional)

  • React.js, Tailwind CSS, Recharts

☁ Cloud/DevOps

  • AWS EC2, S3, CloudWatch, Lambda
  • Docker, GitHub Actions

πŸ“ Project Structure

DeepFleet-AI/
β”œβ”€β”€ backend/
β”‚   β”œβ”€β”€ main.py                # FastAPI entrypoint
β”‚   β”œβ”€β”€ routes/
β”‚   β”‚   β”œβ”€β”€ fleet.py
β”‚   β”‚   └── auth.py
β”‚   β”œβ”€β”€ services/
β”‚   β”‚   └── optimizer.py       # Route optimization logic
β”‚   β”œβ”€β”€ models/
β”‚   β”‚   └── delivery_model.py  # SQLAlchemy models
β”‚   └── utils/
β”‚       └── geo_utils.py       # Geolocation, Haversine formula
β”‚
β”œβ”€β”€ ml/
β”‚   β”œβ”€β”€ model.py               # Fleet routing ML model
β”‚   β”œβ”€β”€ train.py               # Training script
β”‚   β”œβ”€β”€ predict.py             # Inference logic
β”‚   └── data/
β”‚       └── delivery_logs.csv  # Sample training data
β”‚
β”œβ”€β”€ frontend/                  # Optional React Dashboard
β”‚   └── src/
β”‚       └── components/
β”‚       └── pages/
β”‚           └── Dashboard.jsx
β”‚
β”œβ”€β”€ docker/
β”‚   └── Dockerfile
β”‚   └── docker-compose.yml
β”‚
β”œβ”€β”€ scripts/
β”‚   └── seed_db.py             # Populate DB
β”‚   └── scheduler.py           # Fleet update scheduler (Lambda)
β”‚
β”œβ”€β”€ infrastructure/
β”‚   └── terraform/             # AWS setup
β”‚   └── sagemaker-deploy.tf                                                                                                                                 
β”œβ”€β”€ api/                    # Flask backend APIs
β”‚   β”œβ”€β”€ app.py              # API entrypoint
β”‚   β”œβ”€β”€ routes/
β”‚   β”‚   └── delivery_routes.py
β”‚   └── utils/
β”‚       └── helpers.py 
β”œβ”€β”€ README.md
└── requirements.txt  

πŸš€ Features

  • βœ… Predict ETA (Estimated Time of Arrival) using ML
  • βœ… Route Optimization using Haversine/Mapbox APIs
  • βœ… Vehicle Type Classification
  • βœ… Data ingestion from CSV or REST
  • βœ… Scalable deployment with Docker

πŸ“¦ Setup Instructions

1. Clone the repo

git clone https://github.com/hq969/DeepFleet-AI.git
cd DeepFleet-AI

2. Backend Setup

cd api/
python -m venv venv
source venv/bin/activate
pip install -r ../requirements.txt
python app.py

3. Frontend Setup (Optional)

cd frontend/
npm install
npm run dev

4. Run Docker (Alternative)

docker build -t deepfleet-backend .
docker run -p 5000:5000 deepfleet-backend

πŸ“Š Sample API

Endpoint: /predict_eta

POST Body:

{
  "origin": [28.6139, 77.2090],
  "destination": [28.5355, 77.3910],
  "vehicle_type": "van"
}

Response:

{
  "eta_minutes": 42.5
}

πŸ“‚ Dataset

Sample delivery logs can be found in:

ml/data/delivery_logs.csv

You can expand this with more real-world logs.


πŸ“Œ To-Do

  • Integrate Mapbox/Google Directions API
  • Add MongoDB or PostgreSQL for delivery log storage
  • Real-time GPS data streaming via AWS Kinesis

πŸ‘¨β€πŸ’» Contributors


πŸ“„ License

MIT License. Free to use and modify with attribution.


About

DeepFleet-AI is an AI-powered fleet route optimization platform that combines machine learning, geolocation algorithms, and cloud infrastructure to enhance delivery efficiency and reduce operational costs. It offers a modular architecture with a FastAPI backend, Flask APIs, machine learning models, a React frontend (optional), and AWS integration

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors