File size: 1,509 Bytes
49a25b6
 
 
 
 
 
 
 
 
 
 
 
1c06ee5
 
49a25b6
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1c06ee5
49a25b6
1c06ee5
49a25b6
1c06ee5
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
---
title: Uber Driver Recommendation System
emoji: πŸš–
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: "4.31.0"
python_version: "3.10"
app_file: app.py
pinned: false
---

# πŸš– Uber Driver Recommendation System

An intelligent, lightweight ML-powered recommendation system that suggests the best ride options for drivers by optimizing earnings, efficiency, and ride quality.

---

## 🎯 Overview

This project simulates a real-world ride allocation system (like Uber/Ola) where multiple ride requests are ranked and recommended to drivers using a machine learning model.

The system focuses on:
- Maximizing driver earnings πŸ’°
- Minimizing idle time ⏱️
- Improving ride efficiency πŸš—

---

## 🧠 How It Works

1. Synthetic ride data is generated
2. Feature engineering calculates efficiency metrics
3. A Random Forest model predicts a reward score
4. Ride options are ranked based on score
5. Top recommendations are displayed with explanations

---

## βš™οΈ Features

- βœ… ML-based ride scoring engine  
- βœ… Real-time recommendation simulation  
- βœ… Explainable AI ("Why this ride?")  
- βœ… Clean and minimal Gradio UI  
- βœ… Fast and lightweight (HF Spaces ready)  

---

## πŸ“Š Input Parameters

- Pickup Distance (km)
- Trip Distance (km)
- Fare (β‚Ή)
- Surge Multiplier

---

## πŸ“€ Output

- Top 3 recommended rides
- AI-generated score
- Key reasons (high fare, low pickup, surge, etc.)

---

## πŸš€ Run Locally

```bash
pip install -r requirements.txt
python app.py