rexsimiloluwah / inec-ocr-poc

A proof of concept (POC) application for performing OCR on INEC statement of result forms

INER OCR APP 🇳🇬

A POC application for performing OCR on INEC statement of result images

Introduction

Uses

• Python
• PaddleOCR - OCR Engine
• FastAPI
• Docker
• k8s

How it works?

Requirements

• Python 3.x

To run the application locally

1. Clone the repository

$ git clone https://github.com/rexsimiloluwah/inec-ocr-poc.git 
$ cd inec-ocr-poc

2. Setup a virtual environment

# using virtualenv
$ python -m venv env 
$ source env/bin/activate

3. Install the dependencies from requirements.txt

$ pip install -r requirements.txt

4. Run the web server

$ uvicorn src.web.main:app --reload

# using make
$ make start-web

To run the application using Docker

$ docker pull similoluwaokunowo/inec-ocr-app
$ docker run -p 8040:8040 similoluwaokunowo/inec-ocr-app

Testing the application

$ pytest