IDCardRecognition - Docker
This stands for ID card scanner, ID document reader, ID card reader, ID document recognition, passport scanner, ID scanner, MRZ parser, barcode reader, barcode scan, MRZ scan on Linux server.
Overview
The demo project demonstrates the server-based recognition capabilities for ID cards
, passports
, and driver's licenses
.
This stands for ID card scanner server
, ID document reader server
, ID card reader server
, ID document recognition server
, passport scanner server
, ID scanner server
, MRZ parser server
, barcode reader server
, barcode scan server
, MRZ scan server
in python
language on Linux
server
SDK
ID Card Recognition SDK - ServerGithub
dockerhub
Test Online

Postman
To test the API
, you can use Postman
. Here are the endpoints
for testing:
Test with an image file: Send a
POST
request to http://18.221.33.238:8082/idcard_recognitionTest with a
base64-encoded
image: Send aPOST
request to http://18.221.33.238:8082/idcard_recognition_base64You can download the
Postman
collection to easily access and use theseendpoints
. click here

How to Run
1. System Requirements
CPU
: 2 cores or more (Recommended: 2 cores)
RAM
: 4 GB or more (Recommended: 8 GB)
HDD
: 4 GB or more (Recommended: 8 GB)
OS
: Ubuntu 20.04 or later
2. Setup and Test
Clone the project:
git clone https://github.com/kby-ai/IDCardRecognition-Docker.git
Download the model from
Google Drive
and unzip it: click here
cd IDCardRecognition-Docker
wget --load-cookies /tmp/cookies.txt "https://docs.google.com/uc?export=download&confirm=$(wget --quiet --save-cookies /tmp/cookies.txt --keep-session-cookies --no-check-certificate 'https://docs.google.com/uc?export=download&id=1fmTUG7a9IoMA8QiXR9A0xf3Cr6D5UkdC' -O- | sed -rn 's/.*confirm=([0-9A-Za-z_]+).*/\1\n/p')&id=1fmTUG7a9IoMA8QiXR9A0xf3Cr6D5UkdC" -O data.zip && rm -rf /tmp/cookies.txt
unzip data.zip
Build the
Docker
image:
sudo docker build --pull --rm -f Dockerfile -t kby-ai-idcard:latest .
Run the
Docker
container:
sudo docker run -v ./license.txt:/root/kby-ai-idcard/license.txt -p 8082:8080 kby-ai-idcard
Send us the
machine code
and replace thelicense.txt
file you received. Then, run theDocker
container again.


To test the
API
, you can usePostman
. Here are theendpoints
for testing: Test with an image file: Send aPOST
request to http://{xx.xx.xx.xx}:8082/idcard_recognition Test with abase64-encoded
image: Send aPOST
request to http://{xx.xx.xx.xx}:8082/idcard_recognition_base64 You can download thePostman
collection to easily access and use theseendpoints
. click here
3. Execute the Gradio demo
Setup
Gradio
Ensure that you have the necessary dependencies installed.Gradio
requiresPython 3.6
or above. You can installGradio
usingpip
by running the following command:
pip install gradio
Run the demo by using the following command:
cd gradio
python demo.py
You can test within the following
URL
: http://127.0.0.1:9000
Last updated