# Nomeroff Net
<img width="50%" src="https://github.com/ria-com/nomeroff-net/raw/master/public/images/nomeroff_net.svg" alt="Nomeroff Net. Automatic numberplate recognition system"/>
Nomeroff Net. Automatic numberplate recognition system. Version 4.0.0
<br /><br />
<blockquote style="border-left-color: #ff0000">
Now there is a war going on in our country, russian soldiers are shooting at civilians in Ukraine. Enemy aviation launches rockets and drops bombs on residential quarters.
<br>
We are deeply thankful for the unprecedented wave of support for Ukraine from around the world. Below is a list of funds that help the Ukrainian army in the fight against Russian invaders:
<ul>
<li><a href="https://savelife.in.ua/en/">Come back alive</a></li>
<li><a href="https://prytulafoundation.org/en/home/support_page">Serhiy Prytula Charity Foundation</a></li>
</ul>
<img src="https://github.com/ria-com/nomeroff-net/raw/master/public/images/Shelling_of_civilians_in_Ukraine.jpeg?raw=true" alt="Russian troops shelling of civilians in Ukraine. Donbass. Kostyantynivka. 09.07.2022"/>
Photo: Konstantin Liberov https://www.instagram.com/libkos/
</blockquote>
## Introduction
Nomeroff Net is an opensource python license plate
recognition framework based on YOLOv8 bbox and pose
networks and customized OCR-module powered by RNN architecture.
Write to us if you are interested in helping us in the formation of a dataset for your country.
[Change History](https://github.com/ria-com/nomeroff-net/blob/master/History.md).
## Installation
### Installation from Source (Linux)
Nomeroff Net requires Python >= 3.9
Clone Project
```bash
git clone https://github.com/ria-com/nomeroff-net.git
cd nomeroff-net
```
### For Centos, Fedora and other RedHat-like OS:
```bash
# for Opencv
yum install libSM
# for pycocotools install
yum install python3-devel
# ensure that you have installed gcc compiler
yum install gcc
yum install git
# Before "yum install ..." download https://libjpeg-turbo.org/pmwiki/uploads/Downloads/libjpeg-turbo.repo to /etc/yum.repos.d/
yum install libjpeg-turbo-official
```
install requirements:
```bash
pip3 install -r requirements.txt
```
### For Ubuntu and other Debian-like OS:
```bash
# ensure that you have installed gcc compiler
apt-get install gcc
# for opencv install
apt-get install -y libglib2.0
apt-get install -y libgl1-mesa-glx
# for pycocotools install (Check the name of the dev-package for your python3)
apt-get install python3.9-dev
# other packages
apt-get install -y git
apt-get install -y libturbojpeg
```
install requirements:
```bash
pip3 install -r requirements.txt
```
## Hello Nomeroff Net
```python
from nomeroff_net import pipeline
from nomeroff_net.tools import unzip
number_plate_detection_and_reading = pipeline("number_plate_detection_and_reading",
image_loader="opencv")
(images, images_bboxs,
images_points, images_zones, region_ids,
region_names, count_lines,
confidences, texts) = unzip(number_plate_detection_and_reading(['./data/examples/oneline_images/example1.jpeg',
'./data/examples/oneline_images/example2.jpeg']))
print(texts)
```
## Hello Nomeroff Net for systems with a small GPU size.
Note: This example disables some important Nomeroff Net features. It will recognize numbers that are photographed in a horizontal position.
```python
from nomeroff_net import pipeline
from nomeroff_net.tools import unzip
number_plate_detection_and_reading = pipeline("number_plate_short_detection_and_reading",
image_loader="opencv")
(images, images_bboxs,
zones, texts) = unzip(number_plate_detection_and_reading(['./data/examples/oneline_images/example1.jpeg',
'./data/examples/oneline_images/example2.jpeg']))
print(texts)
# (['AC4921CB'], ['RP70012', 'JJF509'])
```
<br><a href="https://github.com/ria-com/nomeroff-net/tree/master/examples">More Examples</a>
## Nomeroff Net Professional
If you don't want to install and configure the Nomeroff Net programmed code for your own tasks or if your client hardware does not have enough resources to run a service that requires ML computing, you can use our commercial [API Nomeroff Net Professional](https://ai.ria.com/ANPR-NomeroffNetProfessional), which allows you to perform recognition remotely on the [RIA.com Сompany](https://ria.company) servers.
The Nomeroff Net Professional API is based on the open source Nomeroff Net engine, with commercial modifications aimed mainly at using improved models that can produce better results in photos with poor image quality.
Right now you can try [ALPR/ANPR Nomeroff Net Professional Demo](https://ai.ria.com/ANPR-NomeroffNetProfessional#ANPR-demo) for free.
## Online Demo
In order to evaluate the quality of work of Nomeroff Net without spending time on setting up and installing, we made an online form in which you can upload your photo and get the [recognition result online](https://nomeroff.net.ua/onlinedemo.html)
## AUTO.RIA Numberplate Dataset
All data on the basis of which the training was conducted is provided by RIA.com.
In the following, we will call this data the [AUTO.RIA Numberplate Dataset](https://nomeroff.net.ua/datasets/autoriaNumberplateDataset-2021-07-21.zip).
We will be grateful for your help in the formation and layout of the dataset with the image of the license plates of your country. For markup, we recommend using [VGG Image Annotator (VIA)](http://www.robots.ox.ac.uk/~vgg/software/via/)
Dataset Example:
<img src="https://github.com/ria-com/nomeroff-net/raw/master/public/images/segment_example.png" alt="Nomeroff-Net Segment Example"/>
## AUTO.RIA Numberplate Options Dataset
The system uses several neural networks. One of them is the classifier of numbers at the post-processing stage. It uses dataset
[AUTO.RIA Numberplate Options Dataset](https://nomeroff.net.ua/datasets/autoriaNumberplateOptionsDataset-2021-09-03.zip).
The categorizer accurately **(99%)** determines the country and the type of license plate. Please note that now the classifier is configured
mainly for the definition of Ukrainian numbers, for other countries it will be necessary to train the classifier with new data.
<img src="https://nomeroff.net.ua/images/nn/clfctr_example.png" alt="Nomeroff-Net OCR Example"/>
## AUTO.RIA Numberplate OCR Datasets
As OCR, we use a specialized implementation of a neural network with RNN layers,
for which we have created several datasets:
* [AUTO.RIA Numberplate OCR UA Dataset (Ukrainian)](https://nomeroff.net.ua/datasets/autoriaNumberplateOcrUa-2021-08-25.zip)
* [AUTO.RIA Numberplate OCR UA Dataset (Ukrainian) with old design Dataset](https://nomeroff.net.ua/datasets/autoriaNumberplateOcrUa-1995-2021-09-03.zip)
* [AUTO.RIA Numberplate OCR EU Dataset (European)](https://nomeroff.net.ua/datasets/autoriaNumberplateOcrEu-2021-09-02.zip)
* [AUTO.RIA Numberplate OCR RU Dataset (Russian)](https://nomeroff.net.ua/datasets/autoriaNumberplateOcrRu-2021-09-01.zip)
* [AUTO.RIA Numberplate OCR KZ Dataset (Kazakh)](https://nomeroff.net.ua/datasets/autoriaNumberplateOcrKz-2019-04-26.zip)
* [AUTO.RIA Numberplate OCR GE Dataset (Georgian)](https://nomeroff.net.ua/datasets/autoriaNumberplateOcrGe-2019-07-06.zip)
* [AUTO.RIA Numberplate OCR BY Dataset (Belarus)](https://nomeroff.net.ua/datasets/autoriaNumberplateOcrBy-2021-08-27.zip)
* [AUTO.RIA Numberplate OCR SU Dataset (exUSSR)](https://nomeroff.net.ua/datasets/autoriaNumberplateOcrSu-2021-09-03.zip)
* [AUTO.RIA Numberplate OCR KG Dataset (Kyrgyzstan)](https://nomeroff.net.ua/datasets/autoriaNumberplateOcrKg-2020-12-31.zip)
* [AUTO.RIA Numberplate OCR AM Dataset (Armenia)](https://nomeroff.net.ua/datasets/autoriaNumberplateOcrAm-2021-05-20-all-draft.zip)
If we did not manage to update the link on dataset you can find the latest version
[here](https://nomeroff.net.ua/datasets/)
This gives you the opportunity to get **99% accuracy**on photos that are uploaded to
[AUTO.RIA](https://auto.ria.com) project
<img src="https://nomeroff.net.ua/images/nn/ocr_example.png" alt="Nomeroff-Net OCR Example"/>
## Contributing
Contributions to this repository are welcome. Examples of things you can contribute:
* Training on other datasets.
* Accuracy Improvements.
## Credits
* Dmytro Probachay <dmytro.probachay@ria.com>
* Oleg Cherniy <oleg.cherniy@ria.com>
## Links
* [Nomeroff Net project site](https://nomeroff.net.ua/)
* [GitHub repository](https://github.com/ria-com/nomeroff-net)
* [Numberplate recognition. Practical guide. Part 1 (in Russian)](https://habr.com/ru/post/432444/)
* [Numberplate recognition. As we got 97% accuracy for Ukrainian numbers. Part 2 (in Russian)](https://habr.com/ru/post/439330/)
* [VIN OCR](https://ai.ria.com/VIN-OCR)
* [ANPR/ALPR Nomeroff Net Professional](https://ai.ria.com/ANPR-NomeroffNetProfessional)
Raw data
{
"_id": null,
"home_page": "https://github.com/ria-com/nomeroff-net",
"name": "nomeroff-net",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "ai nomeroffnet yolo11 yolov8 ocr rnn opensource license number plate recognition licenseplate numberplate license-plate number-plate ria-com ria.com ria",
"author": "Dmytro Probachay, Oleg Cherniy",
"author_email": "dimabendera@gmail.com, oleg.cherniy@ria.com",
"download_url": "https://files.pythonhosted.org/packages/22/ce/bb69ee9b14485d37c0be2fc5595225ba398c249dfc329cadbad31e872c8a/nomeroff-net-4.0.0.tar.gz",
"platform": null,
"description": "# Nomeroff Net\n<img width=\"50%\" src=\"https://github.com/ria-com/nomeroff-net/raw/master/public/images/nomeroff_net.svg\" alt=\"Nomeroff Net. Automatic numberplate recognition system\"/>\n\nNomeroff Net. Automatic numberplate recognition system. Version 4.0.0\n<br /><br />\n<blockquote style=\"border-left-color: #ff0000\">\nNow there is a war going on in our country, russian soldiers are shooting at civilians in Ukraine. Enemy aviation launches rockets and drops bombs on residential quarters.\n<br>\nWe are deeply thankful for the unprecedented wave of support for Ukraine from around the world. Below is a list of funds that help the Ukrainian army in the fight against Russian invaders:\n<ul>\n<li><a href=\"https://savelife.in.ua/en/\">Come back alive</a></li>\n<li><a href=\"https://prytulafoundation.org/en/home/support_page\">Serhiy Prytula Charity Foundation</a></li>\n</ul>\n\n<img src=\"https://github.com/ria-com/nomeroff-net/raw/master/public/images/Shelling_of_civilians_in_Ukraine.jpeg?raw=true\" alt=\"Russian troops shelling of civilians in Ukraine. Donbass. Kostyantynivka. 09.07.2022\"/>\nPhoto: Konstantin Liberov https://www.instagram.com/libkos/\n</blockquote>\n\n## Introduction\nNomeroff Net is an opensource python license plate \nrecognition framework based on YOLOv8 bbox and pose \nnetworks and customized OCR-module powered by RNN architecture.\n\nWrite to us if you are interested in helping us in the formation of a dataset for your country.\n\n[Change History](https://github.com/ria-com/nomeroff-net/blob/master/History.md).\n\n## Installation\n\n### Installation from Source (Linux)\n\nNomeroff Net requires Python >= 3.9\n\nClone Project\n```bash\ngit clone https://github.com/ria-com/nomeroff-net.git\ncd nomeroff-net\n```\n\n### For Centos, Fedora and other RedHat-like OS:\n```bash\n# for Opencv\nyum install libSM\n\n# for pycocotools install \nyum install python3-devel \n\n# ensure that you have installed gcc compiler\nyum install gcc\n\nyum install git\n\n# Before \"yum install ...\" download https://libjpeg-turbo.org/pmwiki/uploads/Downloads/libjpeg-turbo.repo to /etc/yum.repos.d/\nyum install libjpeg-turbo-official\n```\n\ninstall requirements:\n```bash\npip3 install -r requirements.txt \n```\n\n### For Ubuntu and other Debian-like OS:\n```bash\n# ensure that you have installed gcc compiler\napt-get install gcc\n\n# for opencv install\napt-get install -y libglib2.0\napt-get install -y libgl1-mesa-glx\n\n# for pycocotools install (Check the name of the dev-package for your python3)\napt-get install python3.9-dev\n\n# other packages\napt-get install -y git\napt-get install -y libturbojpeg\n```\n\ninstall requirements:\n```bash\npip3 install -r requirements.txt \n```\n\n## Hello Nomeroff Net\n\n```python\nfrom nomeroff_net import pipeline\nfrom nomeroff_net.tools import unzip\n\nnumber_plate_detection_and_reading = pipeline(\"number_plate_detection_and_reading\", \n image_loader=\"opencv\")\n\n(images, images_bboxs, \n images_points, images_zones, region_ids, \n region_names, count_lines, \n confidences, texts) = unzip(number_plate_detection_and_reading(['./data/examples/oneline_images/example1.jpeg', \n './data/examples/oneline_images/example2.jpeg']))\n \nprint(texts)\n```\n\n## Hello Nomeroff Net for systems with a small GPU size.\nNote: This example disables some important Nomeroff Net features. It will recognize numbers that are photographed in a horizontal position.\n\n```python\nfrom nomeroff_net import pipeline\nfrom nomeroff_net.tools import unzip\n\nnumber_plate_detection_and_reading = pipeline(\"number_plate_short_detection_and_reading\", \n image_loader=\"opencv\")\n\n(images, images_bboxs,\n zones, texts) = unzip(number_plate_detection_and_reading(['./data/examples/oneline_images/example1.jpeg', \n './data/examples/oneline_images/example2.jpeg']))\n \nprint(texts)\n# (['AC4921CB'], ['RP70012', 'JJF509'])\n```\n\n\n<br><a href=\"https://github.com/ria-com/nomeroff-net/tree/master/examples\">More Examples</a>\n\n\n## Nomeroff Net Professional\n\nIf you don't want to install and configure the Nomeroff Net programmed code for your own tasks or if your client hardware does not have enough resources to run a service that requires ML computing, you can use our commercial [API Nomeroff Net Professional](https://ai.ria.com/ANPR-NomeroffNetProfessional), which allows you to perform recognition remotely on the [RIA.com \u0421ompany](https://ria.company) servers.\n\nThe Nomeroff Net Professional API is based on the open source Nomeroff Net engine, with commercial modifications aimed mainly at using improved models that can produce better results in photos with poor image quality.\n\nRight now you can try [ALPR/ANPR Nomeroff Net Professional Demo](https://ai.ria.com/ANPR-NomeroffNetProfessional#ANPR-demo) for free.\n\n## Online Demo\nIn order to evaluate the quality of work of Nomeroff Net without spending time on setting up and installing, we made an online form in which you can upload your photo and get the [recognition result online](https://nomeroff.net.ua/onlinedemo.html)\n\n## AUTO.RIA Numberplate Dataset\nAll data on the basis of which the training was conducted is provided by RIA.com. \nIn the following, we will call this data the [AUTO.RIA Numberplate Dataset](https://nomeroff.net.ua/datasets/autoriaNumberplateDataset-2021-07-21.zip).\n\nWe will be grateful for your help in the formation and layout of the dataset with the image of the license plates of your country. For markup, we recommend using [VGG Image Annotator (VIA)](http://www.robots.ox.ac.uk/~vgg/software/via/)\n\nDataset Example:\n<img src=\"https://github.com/ria-com/nomeroff-net/raw/master/public/images/segment_example.png\" alt=\"Nomeroff-Net Segment Example\"/>\n\n## AUTO.RIA Numberplate Options Dataset\nThe system uses several neural networks. One of them is the classifier of numbers at the post-processing stage. It uses dataset\n[AUTO.RIA Numberplate Options Dataset](https://nomeroff.net.ua/datasets/autoriaNumberplateOptionsDataset-2021-09-03.zip).\n\nThe categorizer accurately **(99%)** determines the country and the type of license plate. Please note that now the classifier is configured\nmainly for the definition of Ukrainian numbers, for other countries it will be necessary to train the classifier with new data.\n\n<img src=\"https://nomeroff.net.ua/images/nn/clfctr_example.png\" alt=\"Nomeroff-Net OCR Example\"/>\n\n## AUTO.RIA Numberplate OCR Datasets\nAs OCR, we use a specialized implementation of a neural network with RNN layers,\nfor which we have created several datasets:\n * [AUTO.RIA Numberplate OCR UA Dataset (Ukrainian)](https://nomeroff.net.ua/datasets/autoriaNumberplateOcrUa-2021-08-25.zip)\n * [AUTO.RIA Numberplate OCR UA Dataset (Ukrainian) with old design Dataset](https://nomeroff.net.ua/datasets/autoriaNumberplateOcrUa-1995-2021-09-03.zip)\n * [AUTO.RIA Numberplate OCR EU Dataset (European)](https://nomeroff.net.ua/datasets/autoriaNumberplateOcrEu-2021-09-02.zip)\n * [AUTO.RIA Numberplate OCR RU Dataset (Russian)](https://nomeroff.net.ua/datasets/autoriaNumberplateOcrRu-2021-09-01.zip)\n * [AUTO.RIA Numberplate OCR KZ Dataset (Kazakh)](https://nomeroff.net.ua/datasets/autoriaNumberplateOcrKz-2019-04-26.zip)\n * [AUTO.RIA Numberplate OCR GE Dataset (Georgian)](https://nomeroff.net.ua/datasets/autoriaNumberplateOcrGe-2019-07-06.zip)\n * [AUTO.RIA Numberplate OCR BY Dataset (Belarus)](https://nomeroff.net.ua/datasets/autoriaNumberplateOcrBy-2021-08-27.zip)\n * [AUTO.RIA Numberplate OCR SU Dataset (exUSSR)](https://nomeroff.net.ua/datasets/autoriaNumberplateOcrSu-2021-09-03.zip)\n * [AUTO.RIA Numberplate OCR KG Dataset (Kyrgyzstan)](https://nomeroff.net.ua/datasets/autoriaNumberplateOcrKg-2020-12-31.zip)\n * [AUTO.RIA Numberplate OCR AM Dataset (Armenia)](https://nomeroff.net.ua/datasets/autoriaNumberplateOcrAm-2021-05-20-all-draft.zip)\n\nIf we did not manage to update the link on dataset you can find the latest version \n[here](https://nomeroff.net.ua/datasets/)\n\nThis gives you the opportunity to get **99% accuracy**on photos that are uploaded to \n[AUTO.RIA](https://auto.ria.com) project\n\n<img src=\"https://nomeroff.net.ua/images/nn/ocr_example.png\" alt=\"Nomeroff-Net OCR Example\"/>\n\n## Contributing\nContributions to this repository are welcome. Examples of things you can contribute:\n * Training on other datasets.\n * Accuracy Improvements.\n\n## Credits\n * Dmytro Probachay <dmytro.probachay@ria.com>\n * Oleg Cherniy <oleg.cherniy@ria.com>\n\n## Links\n * [Nomeroff Net project site](https://nomeroff.net.ua/)\n * [GitHub repository](https://github.com/ria-com/nomeroff-net)\n * [Numberplate recognition. Practical guide. Part 1 (in Russian)](https://habr.com/ru/post/432444/)\n * [Numberplate recognition. As we got 97% accuracy for Ukrainian numbers. Part 2 (in Russian)](https://habr.com/ru/post/439330/)\n * [VIN OCR](https://ai.ria.com/VIN-OCR)\n * [ANPR/ALPR Nomeroff Net Professional](https://ai.ria.com/ANPR-NomeroffNetProfessional)\n",
"bugtrack_url": null,
"license": "GNU General Public License v3.0",
"summary": "Automatic numberplate recognition system",
"version": "4.0.0",
"project_urls": {
"Homepage": "https://github.com/ria-com/nomeroff-net"
},
"split_keywords": [
"ai",
"nomeroffnet",
"yolo11",
"yolov8",
"ocr",
"rnn",
"opensource",
"license",
"number",
"plate",
"recognition",
"licenseplate",
"numberplate",
"license-plate",
"number-plate",
"ria-com",
"ria.com",
"ria"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "6e937310f84e2060b7f3ed31baee27e0ab2c6390a3787c50905893de909222d0",
"md5": "cf94e897261eaec1a680f66b263a4477",
"sha256": "cd4df98e625d8d26a0cd2887eb8aaf75a8e78c22c73ec084c557d95f3f58ba35"
},
"downloads": -1,
"filename": "nomeroff_net-4.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "cf94e897261eaec1a680f66b263a4477",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 128553,
"upload_time": "2024-12-03T19:59:49",
"upload_time_iso_8601": "2024-12-03T19:59:49.845013Z",
"url": "https://files.pythonhosted.org/packages/6e/93/7310f84e2060b7f3ed31baee27e0ab2c6390a3787c50905893de909222d0/nomeroff_net-4.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "22cebb69ee9b14485d37c0be2fc5595225ba398c249dfc329cadbad31e872c8a",
"md5": "9f676e6dcaddc053de2035cc0ff13cae",
"sha256": "a0f2cc54e2a16cfbf1399b915d52da2b5ff0bdeac10aec068c33f351e624d969"
},
"downloads": -1,
"filename": "nomeroff-net-4.0.0.tar.gz",
"has_sig": false,
"md5_digest": "9f676e6dcaddc053de2035cc0ff13cae",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 94769,
"upload_time": "2024-12-03T19:59:51",
"upload_time_iso_8601": "2024-12-03T19:59:51.307035Z",
"url": "https://files.pythonhosted.org/packages/22/ce/bb69ee9b14485d37c0be2fc5595225ba398c249dfc329cadbad31e872c8a/nomeroff-net-4.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-03 19:59:51",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ria-com",
"github_project": "nomeroff-net",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "cython",
"specs": []
},
{
"name": "setuptools",
"specs": []
},
{
"name": "numpy",
"specs": []
},
{
"name": "opencv_python",
"specs": []
},
{
"name": "scikit_image",
"specs": []
},
{
"name": "asyncio",
"specs": []
},
{
"name": "gitpython",
"specs": []
},
{
"name": "pycocotools",
"specs": []
},
{
"name": "ujson",
"specs": []
},
{
"name": "pillow",
"specs": []
},
{
"name": "tqdm",
"specs": []
},
{
"name": "matplotlib",
"specs": []
},
{
"name": "scipy",
"specs": []
},
{
"name": "torch",
"specs": [
[
">=",
"1.12"
]
]
},
{
"name": "torchvision",
"specs": [
[
">=",
"0.13"
]
]
},
{
"name": "PyYAML",
"specs": [
[
">=",
"5.4"
]
]
},
{
"name": "seaborn",
"specs": []
},
{
"name": "pytorch_lightning",
"specs": [
[
"==",
"1.8.6"
]
]
},
{
"name": "ipywidgets",
"specs": []
},
{
"name": "gevent",
"specs": []
},
{
"name": "termcolor",
"specs": []
},
{
"name": "scikit-learn",
"specs": []
},
{
"name": "ultralytics",
"specs": [
[
">=",
"8.3.12"
]
]
},
{
"name": "albumentations",
"specs": []
},
{
"name": "craft_text_detector",
"specs": []
},
{
"name": "PyTurboJPEG",
"specs": []
},
{
"name": "modelhub_client",
"specs": []
}
],
"lcname": "nomeroff-net"
}
JSON
