Himanshu2003 commited on
Commit
5f18f57
Β·
verified Β·
1 Parent(s): 07be9ea

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +102 -17
README.md CHANGED
@@ -1,15 +1,76 @@
1
  ---
2
  title: PlateVision
3
  emoji: πŸš—
4
- colorFrom: blue
5
- colorTo: blue
6
  sdk: streamlit
7
  pinned: false
8
  sdk_version: 1.50.0
9
  short_description: AI-Powered License Plate Detection & Recognition from Images
 
 
 
 
 
10
 
 
 
 
 
 
11
 
12
  ---
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
13
  # πŸš— PlateVision πŸ”
14
  ### AI-Powered License Plate Detection & Recognition from Images and Videos
15
 
@@ -17,29 +78,53 @@ short_description: AI-Powered License Plate Detection & Recognition from Images
17
 
18
  ## 🧠 Overview
19
 
20
- **PlateVision** is an AI-powered web app built with **Streamlit** that detects and recognizes vehicle license plates from **images** and **videos** using a fine-tuned **YOLO** model and **EasyOCR**.
21
 
22
- It combines **object detection** and **optical character recognition (OCR)** into a simple, intuitive interface where users can upload media files and get annotated outputs in seconds.
23
 
24
  ---
25
 
26
  ## ✨ Features
27
 
28
- βœ… Detects license plates from images or videos
29
- βœ… Extracts plate numbers using OCR (EasyOCR)
30
- βœ… Displays detection confidence and recognized text
31
- βœ… Supports multiple file formats (`.jpg`, `.jpeg`, `.png`, `.mp4`, `.mkv`)
32
- βœ… Real-time progress bar for video processing
33
- βœ… Clean Streamlit UI for quick interaction
34
- βœ… Outputs processed results with bounding boxes and text overlay
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
35
 
36
  ---
37
 
38
  ## 🧩 Tech Stack
39
 
40
- - **Frontend & UI:** Streamlit
41
- - **Object Detection:** YOLOv8 (Ultralytics)
42
- - **OCR Engine:** EasyOCR
43
- - **Computer Vision:** OpenCV
44
- - **Video Handling:** MoviePy
45
- - **Language:** Python 3.9+
 
 
 
 
 
1
  ---
2
  title: PlateVision
3
  emoji: πŸš—
4
+ colorFrom: indigo
5
+ colorTo: pink
6
  sdk: streamlit
7
  pinned: false
8
  sdk_version: 1.50.0
9
  short_description: AI-Powered License Plate Detection & Recognition from Images
10
+ ---
11
+ # πŸš— PlateVision πŸ”
12
+ ### AI-Powered License Plate Detection & Recognition from Images and Videos
13
+
14
+ ---
15
 
16
+ ## 🧠 Overview
17
+
18
+ **PlateVision** is an AI-powered web app built with **Streamlit** that detects and recognizes vehicle license plates from **images** and **videos** using a **fine-tuned YOLOv8 model** and **EasyOCR**.
19
+
20
+ It seamlessly combines **object detection** and **optical character recognition (OCR)** to deliver a simple, intuitive, and interactive platform where users can upload their media files and get annotated results in seconds β€” complete with **confidence scores** and **recognized text overlays**.
21
 
22
  ---
23
+
24
+ ## ✨ Features
25
+
26
+ βœ… Detects license plates from both **images** and **videos**
27
+ βœ… Extracts **license numbers** using OCR (EasyOCR)
28
+ βœ… Displays **detection confidence** and recognized text on output
29
+ βœ… Supports multiple formats β€” `.jpg`, `.jpeg`, `.png`, `.mp4`, `.mkv`
30
+ βœ… Shows **real-time progress** while processing videos
31
+ βœ… Provides a **clean Streamlit interface** for easy interaction
32
+ βœ… Outputs processed results with bounding boxes and plate numbers drawn on frames
33
+
34
+ ---
35
+
36
+ ## βš™οΈ How It Works
37
+
38
+ 1. **Upload Input File**
39
+ - The user uploads an image or video through the Streamlit interface.
40
+
41
+ 2. **License Plate Detection (YOLOv8)**
42
+ - A **custom fine-tuned YOLOv8 model** detects the position of license plates in the media.
43
+
44
+ 3. **Text Recognition (EasyOCR)**
45
+ - The detected plate region is passed through **EasyOCR** to read and extract the license number.
46
+
47
+ 4. **Annotation & Output**
48
+ - Detected plates are annotated with bounding boxes, confidence percentages, and extracted text.
49
+ - For videos, frames are processed sequentially and stitched back together using **MoviePy**.
50
+
51
+ 5. **Display**
52
+ - The processed media (image or video) is displayed directly in the Streamlit app.
53
+
54
+ ---
55
+
56
+ ## 🧩 Tech Stack
57
+
58
+ | Component | Technology / Library | Purpose |
59
+ |------------|----------------------|----------|
60
+ | 🧱 Frontend & UI | **Streamlit** | Builds the interactive web interface |
61
+ | 🧠 Object Detection | **YOLOv8 (Ultralytics)** | Detects license plate locations |
62
+ | πŸ” OCR Engine | **EasyOCR** | Recognizes alphanumeric text from plates |
63
+ | πŸŽ₯ Video Handling | **MoviePy** | Processes and reconstructs video frames |
64
+ | πŸ‘οΈ Computer Vision | **OpenCV** | Image manipulation and annotation |
65
+ | πŸ’Ύ Language | **Python 3.11+** | Development language |
66
+
67
+ ---
68
+
69
+ ## πŸš€ Quick Start
70
+
71
+ ### 1️⃣ Install Dependencies
72
+ ```bash
73
+ pip install -r requirements.txt
74
  # πŸš— PlateVision πŸ”
75
  ### AI-Powered License Plate Detection & Recognition from Images and Videos
76
 
 
78
 
79
  ## 🧠 Overview
80
 
81
+ **PlateVision** is an AI-powered web app built with **Streamlit** that detects and recognizes vehicle license plates from **images** and **videos** using a **fine-tuned YOLOv8 model** and **EasyOCR**.
82
 
83
+ It seamlessly combines **object detection** and **optical character recognition (OCR)** to deliver a simple, intuitive, and interactive platform where users can upload their media files and get annotated results in seconds β€” complete with **confidence scores** and **recognized text overlays**.
84
 
85
  ---
86
 
87
  ## ✨ Features
88
 
89
+ βœ… Detects license plates from both **images** and **videos**
90
+ βœ… Extracts **license numbers** using OCR (EasyOCR)
91
+ βœ… Displays **detection confidence** and recognized text on output
92
+ βœ… Supports multiple formats β€” `.jpg`, `.jpeg`, `.png`, `.mp4`, `.mkv`
93
+ βœ… Shows **real-time progress** while processing videos
94
+ βœ… Provides a **clean Streamlit interface** for easy interaction
95
+ βœ… Outputs processed results with bounding boxes and plate numbers drawn on frames
96
+
97
+ ---
98
+
99
+ ## βš™οΈ How It Works
100
+
101
+ 1. **Upload Input File**
102
+ - The user uploads an image or video through the Streamlit interface.
103
+
104
+ 2. **License Plate Detection (YOLOv8)**
105
+ - A **custom fine-tuned YOLOv8 model** detects the position of license plates in the media.
106
+
107
+ 3. **Text Recognition (EasyOCR)**
108
+ - The detected plate region is passed through **EasyOCR** to read and extract the license number.
109
+
110
+ 4. **Annotation & Output**
111
+ - Detected plates are annotated with bounding boxes, confidence percentages, and extracted text.
112
+ - For videos, frames are processed sequentially and stitched back together using **MoviePy**.
113
+
114
+ 5. **Display**
115
+ - The processed media (image or video) is displayed directly in the Streamlit app.
116
 
117
  ---
118
 
119
  ## 🧩 Tech Stack
120
 
121
+ | Component | Technology / Library | Purpose |
122
+ |------------|----------------------|----------|
123
+ | 🧱 Frontend & UI | **Streamlit** | Builds the interactive web interface |
124
+ | 🧠 Object Detection | **YOLOv8 (Ultralytics)** | Detects license plate locations |
125
+ | πŸ” OCR Engine | **EasyOCR** | Recognizes alphanumeric text from plates |
126
+ | πŸŽ₯ Video Handling | **MoviePy** | Processes and reconstructs video frames |
127
+ | πŸ‘οΈ Computer Vision | **OpenCV** | Image manipulation and annotation |
128
+ | πŸ’Ύ Language | **Python 3.11+** | Development language |
129
+
130
+ ---