Skip to content

faisalthaheem/open-lpr

Repository files navigation

Repository Last commit Docker CI Health Docker pulls
FTP GithubLastCommit Docker Image CI DockerPulls
Plate Detection GithubLastCommit Docker Image CI DockerPulls
OCR GithubLastCommit Docker Image CI DockerPulls
REST GithubLastCommit Docker Image CI DockerPulls
NodeRed GithubLastCommit Docker Image CI DockerPulls

TOC

Demo

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.


About

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 Action | LPR Performed on an image and results displayed in NodeRED Dashboard

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
        ]
    ]
}



Quick Start in 3 steps

The following instrctions assume you are running a linux flavor such as debian, ubuntu or popos!

1. Install Docker

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.

2. Clone this repo & start services

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/

Optional - Upload a file using FTP

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.



REST Interface

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



Training your own Plate Detection Models

Please follow instructions given in the following repo OpenLPR Pre-trained models



Documentation & Updates

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.



Milestones

Work on GPU supported container images is in progress.

Milestones



Overview

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.

Overview