{"id":20165793,"url":"https://github.com/aliktk/anpr-training-recognition-app","last_synced_at":"2025-11-29T07:05:11.512Z","repository":{"id":259086254,"uuid":"864087962","full_name":"Aliktk/anpr-training-recognition-app","owner":"Aliktk","description":"Automatic Number Plate Recognition (ANPR) Using YOLOv8 and easyOCR","archived":false,"fork":false,"pushed_at":"2024-10-21T17:59:07.000Z","size":27187,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-13T14:52:51.977Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Aliktk.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}},"created_at":"2024-09-27T13:21:20.000Z","updated_at":"2024-10-21T17:59:11.000Z","dependencies_parsed_at":"2024-10-22T13:29:11.765Z","dependency_job_id":null,"html_url":"https://github.com/Aliktk/anpr-training-recognition-app","commit_stats":null,"previous_names":["aliktk/anpr-training-recognition-app"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aliktk%2Fanpr-training-recognition-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aliktk%2Fanpr-training-recognition-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aliktk%2Fanpr-training-recognition-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aliktk%2Fanpr-training-recognition-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Aliktk","download_url":"https://codeload.github.com/Aliktk/anpr-training-recognition-app/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241601765,"owners_count":19988975,"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","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":[],"created_at":"2024-11-14T00:39:08.191Z","updated_at":"2025-11-29T07:05:11.406Z","avatar_url":"https://github.com/Aliktk.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚗 License Plate Detection System\n\nThis project implements a License Plate Detection System using **YOLOv8** and **EasyOCR**. The system detects and localizes license plates from vehicle images and performs OCR (Optical Character Recognition) to extract the text from the detected plates. The application can be run in CLI mode for real-time detection and can also be deployed as a web-based application using **Streamlit**.\n\n---\n\n## 📚 Table of Contents\n\n- [🚗 License Plate Detection System](#-license-plate-detection-system)\n  - [📚 Table of Contents](#-table-of-contents)\n  - [✨ Features](#-features)\n  - [📁 Project Structure](#-project-structure)\n  - [Prerequisites ⚙️](#prerequisites-️)\n  - [How to Run 🚀](#how-to-run-)\n    - [Running the Detection System (CLI) 🖥️](#running-the-detection-system-cli-️)\n  - [Running the Streamlit App 🌐](#running-the-streamlit-app-)\n  - [Using the Streamlit App Features 🛠️](#using-the-streamlit-app-features-️)\n  - [Configuration ⚙️](#configuration-️)\n    - [Example Configuration:](#example-configuration)\n  - [Example Usage 📋](#example-usage-)\n    - [CLI Detection for Image 📷](#cli-detection-for-image-)\n  - [Example Usage](#example-usage)\n    - [CLI Detection for Video 🎥](#cli-detection-for-video-)\n  - [Future Enhancements 🚀](#future-enhancements-)\n  - [Acknowledgements 🙏](#acknowledgements-)\n  - [Follow Us for Updates! 🌟](#follow-us-for-updates-)\n\n---\n\n## ✨ Features\n\n- **YOLOv8-Based License Plate Detection**: Utilizes the YOLOv8 object detection model for accurate and fast license plate localization. 🎯\n- **EasyOCR for Text Extraction**: Integrates EasyOCR to extract text from localized license plates. 📝\n- **CLI Support**: Provides command-line functionality for detection on video files or images. 💻\n- **Streamlit Integration**: Deploy a user-friendly web interface to upload and detect license plates interactively. 🌐\n- **Custom Dataset**: The model is trained on a custom dataset using Roboflow for precise performance. 📊\n\n---\n\n## 📁 Project Structure\n\n```\n├── app/                    # Streamlit app code\n├── App Test Data/                 # Pre-trained models or checkpoints\ndataset/\n├── train/\n│   ├── images/\n│   │   ├── image1.jpg\n│   │   ├── image2.jpg\n│   └── labels/\n│       ├── image1.txt\n│       ├── image2.txt\n├── valid/\n│   ├── images/\n│   │   ├── image1.jpg\n│   │   ├── image2.jpg\n│   └── labels/\n│       ├── image1.txt\n├── runs/                   # Model checkpoints and result logs\n|── ultralytics/                   # Log files for detection process\n├── models/                 # Pre-trained models or checkpoints\n├── detect_modified.py       # Main detection script with YOLOv8 and OCR\n├── requirements.txt        # Python dependencies\n└── config.yaml\n└── custom_training.ipynb\n└── data.yaml\n└── LICENSE\n└── predict_modified.py\n└── README.md\n└── requirements.txt\n└── train_test.ipynb\n└── ultralytics\n```\n## Prerequisites ⚙️\n\nEnsure you have the following installed:\n\n- Python 3.8+ 🐍\n- CUDA-enabled GPU (if you want to run it on GPU) 🖥️\n- `easyocr`, `torch`, `ultralytics`, `opencv-python`, and `streamlit` Python libraries (refer to `requirements.txt`)\n\nTo install dependencies, run:\n\n```bash\npip install -r requirements.txt\n```\n\n## How to Run 🚀\n\n### Running the Detection System (CLI) 🖥️\n\nYou can run the License Plate Detection System in CLI mode by executing the following command:\n\n```bash\npython detect_modified.py model='ultralytics/runs/detect/train_model/weights/best.pt' source='path_to_video_or_image'\n```\n\nReplace `path_to_video_or_image` with the path to your input file (video or image). The detected license plates will be displayed, and OCR will be performed to extract the text.\n\n## Running the Streamlit App 🌐\n\nTo interact with the detection system via a web interface, run the Streamlit app:\n\n1. Navigate to the app directory where the `Main.py` file is located. 📁\n2. Run the following command:\n\n   ```bash\n   streamlit run app/Main.py\n   ```\n\nThis will launch the Streamlit web app on localhost. You can upload images or videos, and the app will detect and display the results, including the extracted license plate text. 📸\n\n---\n\n## Future Enhancements 🚀\n\n- **OCR Language Support:** Add support for multiple languages for OCR using EasyOCR. 🌍\n- **Improved Post-processing:** Implement advanced post-processing to enhance OCR results on low-quality license plates. 🔧\n- **Real-time Video Stream Support:** Extend functionality to support real-time detection from a video feed (e.g., a camera). 📹\n\n## Acknowledgements 🙏\n\n- **YOLOv8:** For the base model used for object detection.\n- **EasyOCR:** For Optical Character Recognition.\n\n## Follow Us for Updates! 🌟\n\nStay tuned for updates and enhancements to the License Plate Detection System!\n\n- **GitHub:** [Alitktk](https://github.com/Alitktk) – Check out the repository for the latest code and releases. ⭐️\n- **Feedback:** Your feedback is important! Please raise issues or suggestions on GitHub.\n- **Social Media:** Follow us on [Twitter](https://www.twitter.com/engr_ali_nawaz)) and [LinkedIn](https://www.linkedin.com/in/ali-nawaz-khattak/) for the latest news and updates!\n\nThank you for your support! 💖\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faliktk%2Fanpr-training-recognition-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faliktk%2Fanpr-training-recognition-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faliktk%2Fanpr-training-recognition-app/lists"}