{"id":30799778,"url":"https://github.com/hq969/deepfleet-ai","last_synced_at":"2026-04-11T19:06:42.232Z","repository":{"id":307944757,"uuid":"1031155871","full_name":"hq969/DeepFleet-AI","owner":"hq969","description":"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","archived":false,"fork":false,"pushed_at":"2025-08-04T06:10:12.000Z","size":45,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-02T15:01:30.750Z","etag":null,"topics":["aws","fastapi","reactjs","terraform"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hq969.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-03T06:06:52.000Z","updated_at":"2025-08-04T06:10:16.000Z","dependencies_parsed_at":"2025-08-03T08:26:15.396Z","dependency_job_id":"9717bb28-580a-475d-9888-ff2f79475be9","html_url":"https://github.com/hq969/DeepFleet-AI","commit_stats":null,"previous_names":["hq969/deepfleet-ai"],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/hq969/DeepFleet-AI","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hq969%2FDeepFleet-AI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hq969%2FDeepFleet-AI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hq969%2FDeepFleet-AI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hq969%2FDeepFleet-AI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hq969","download_url":"https://codeload.github.com/hq969/DeepFleet-AI/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hq969%2FDeepFleet-AI/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273813209,"owners_count":25172892,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-05T02:00:09.113Z","response_time":402,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aws","fastapi","reactjs","terraform"],"created_at":"2025-09-05T19:53:49.530Z","updated_at":"2025-12-30T21:29:11.284Z","avatar_url":"https://github.com/hq969.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DeepFleet-AI 🚚📦  \n**AI-Powered Logistics Fleet Optimization System**\n\nDeepFleet-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.\n\n---\n\n## 🌐 Tech Stack\n\n### 🧠 Backend \u0026 ML\n- **Python**, **Flask**\n- **Scikit-learn**, **Pandas**, **NumPy**, **XGBoost**\n- **Geopy**, **Haversine**, **Folium**\n\n### 🌍 Frontend (optional)\n- **React.js**, **Tailwind CSS**, **Recharts**\n\n### ☁ Cloud/DevOps\n- **AWS EC2**, **S3**, **CloudWatch**, **Lambda**\n- **Docker**, **GitHub Actions**\n\n---\n\n## 📁 Project Structure\n\n```bash\nDeepFleet-AI/\n├── backend/\n│   ├── main.py                # FastAPI entrypoint\n│   ├── routes/\n│   │   ├── fleet.py\n│   │   └── auth.py\n│   ├── services/\n│   │   └── optimizer.py       # Route optimization logic\n│   ├── models/\n│   │   └── delivery_model.py  # SQLAlchemy models\n│   └── utils/\n│       └── geo_utils.py       # Geolocation, Haversine formula\n│\n├── ml/\n│   ├── model.py               # Fleet routing ML model\n│   ├── train.py               # Training script\n│   ├── predict.py             # Inference logic\n│   └── data/\n│       └── delivery_logs.csv  # Sample training data\n│\n├── frontend/                  # Optional React Dashboard\n│   └── src/\n│       └── components/\n│       └── pages/\n│           └── Dashboard.jsx\n│\n├── docker/\n│   └── Dockerfile\n│   └── docker-compose.yml\n│\n├── scripts/\n│   └── seed_db.py             # Populate DB\n│   └── scheduler.py           # Fleet update scheduler (Lambda)\n│\n├── infrastructure/\n│   └── terraform/             # AWS setup\n│   └── sagemaker-deploy.tf                                                                                                                                 \n├── api/                    # Flask backend APIs\n│   ├── app.py              # API entrypoint\n│   ├── routes/\n│   │   └── delivery_routes.py\n│   └── utils/\n│       └── helpers.py \n├── README.md\n└── requirements.txt  \n````\n\n---\n\n## 🚀 Features\n\n* ✅ Predict ETA (Estimated Time of Arrival) using ML\n* ✅ Route Optimization using Haversine/Mapbox APIs\n* ✅ Vehicle Type Classification\n* ✅ Data ingestion from CSV or REST\n* ✅ Scalable deployment with Docker\n\n---\n\n## 📦 Setup Instructions\n\n### 1. Clone the repo\n\n```bash\ngit clone https://github.com/hq969/DeepFleet-AI.git\ncd DeepFleet-AI\n```\n\n### 2. Backend Setup\n\n```bash\ncd api/\npython -m venv venv\nsource venv/bin/activate\npip install -r ../requirements.txt\npython app.py\n```\n\n### 3. Frontend Setup (Optional)\n\n```bash\ncd frontend/\nnpm install\nnpm run dev\n```\n\n### 4. Run Docker (Alternative)\n\n```bash\ndocker build -t deepfleet-backend .\ndocker run -p 5000:5000 deepfleet-backend\n```\n\n---\n\n## 📊 Sample API\n\n**Endpoint:** `/predict_eta`\n\n**POST Body:**\n\n```json\n{\n  \"origin\": [28.6139, 77.2090],\n  \"destination\": [28.5355, 77.3910],\n  \"vehicle_type\": \"van\"\n}\n```\n\n**Response:**\n\n```json\n{\n  \"eta_minutes\": 42.5\n}\n```\n\n---\n\n## 📂 Dataset\n\nSample delivery logs can be found in:\n\n```\nml/data/delivery_logs.csv\n```\n\nYou can expand this with more real-world logs.\n\n---\n\n## 📌 To-Do\n\n* [ ] Integrate Mapbox/Google Directions API\n* [ ] Add MongoDB or PostgreSQL for delivery log storage\n* [ ] Real-time GPS data streaming via AWS Kinesis\n\n---\n\n## 👨‍💻 Contributors\n\n* **Harsh Sonkar** —  [LinkedIn](https://www.linkedin.com/in/harsh-sonkar-232573250)\n\n---\n\n## 📄 License\n\nMIT License. Free to use and modify with attribution.\n\n---\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhq969%2Fdeepfleet-ai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhq969%2Fdeepfleet-ai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhq969%2Fdeepfleet-ai/lists"}