Repository | Last commit | Docker CI Health | Docker pulls |
---|---|---|---|
FTP | |||
Plate Detection | |||
OCR | |||
REST | |||
NodeRed |
Please note the demo server is deliberately kept underpowered to prevent abuse. In case your request times out the server may just be too busy with other requests. You can always try running OpenLPR locally as described below.
Free forever & Open Source License Plate Recognition software which uses deep neural networks to detect license plates and perform OCR.
Following image illustrates a dashboard built using nodered that shows real time LPR results. NodeRED can be used to build RESTful services, integrate with other systems such as over modbus to extend the business functionality of the system with ease.
In the above example it can be see that LPR was performed on the image uploaded through FTP and text 349253 was extracted successfully from the license plate area.
An abundance of information such as bounding boxes, confidence scores etc are available in the raw JSON data published by the services and available to NodeRED and any other integrating service for consumption.
For the above example, the following detail is available in db and also published on the message broker (RabbitMQ) and is as well available in NodeRED for further processing, furthermore this detail is also returned as JSON when using the REST (described further below) interface
{
"_id" : "522676bf-c958-49cb-b786-32b3d0407c02",
"filename" : "jeep.jpg",
"creationtime" : 1645719472.51666,
"unique_name" : "522676bf-c958-49cb-b786-32b3d0407c02_jeep.jpg",
"detections" : {
"boxes" : [
[
348,
400,
740,
546
]
],
"scores" : [
0.998433649539948
],
"classes" : [
2
]
},
"imgDimensions" : {
"height" : 1281,
"width" : 720,
"channels" : "RGB"
},
"ocr" : [
[
"349253",
0.996076437906518
]
]
}
The following instrctions assume you are running a linux flavor such as debian, ubuntu or popos!
Goto https://www.docker.com/get-started and install the distribution relevant to your operating system. Consider using a convenience script to fast track the installation. Also install docker-compose.
This step will take a few minutes depending on your internet connection speed. Use "bash" shell to issue the following commands
git clone https://github.com/faisalthaheem/open-lpr && \
cd open-lpr && \
docker-compose up -d
Important Images are updated frequently, therefore to ensure you are running the latest version consider using watchtower.
3. Open your browser and upload file to process
Use google chrome to navigate to the following address http://localhost:5000/
Use any FTP client, for example, FileZilla to connect to your localhost on port 2121 with the username and password user/12345 and upload any car image with readable license plate.
The dashboard at http://localhost:1890/show-dashboard will update to reflect the detected plate and OCR text like in the image above.
You can use the REST interface to submit an image for processing. Once services have started a command similar to following can be used from the shell to try it out; you can ofcourse use the REST interface with any programming language.
curl \
-F "filecomment=Sample file" \
-F "image=@/path/to/image.jpg" \
localhost:5000/process
In the above command image==@/path/to/image.jpg
points to the file that is to be submitted for processing, and localhost:5000 represents where the OpenLPR services are running.
The returned response is JSON as given in the example above
Please follow instructions given in the following repo OpenLPR Pre-trained models
Head over to the wiki for documentation.
Dated | Description |
---|---|
Feb 2022 | Added arm64 support to all containers except OCR and detection. |
Feb 2022 | Added REST interface. |
Feb 2022 | Ported stack to torch. Removed plate classification. |
Feb 2022 | Completed documentation. |
Jan 2021 | Ported to tensorflow 2 with compatibility mode for tensorflow 1. |
Open LPR is a distributed system aimed towards ease of management and high LPR throughput. The core consists of modules to perform the tasks of plate detection, classification and OCR.
Ground up the system is built to be scalable and can handle the load of a single site to a city wide area.
The entire stack is built on top of docker containers and is available in cpu only and gpu supported runtimes. Tensorflow, Keras and OpenCV are used amongst other libraries to deliver the service.