{"id":20358003,"url":"https://github.com/arnabd64/aadhar-card-entity-extract","last_synced_at":"2026-01-18T17:33:26.507Z","repository":{"id":200407612,"uuid":"705251470","full_name":"arnabd64/Aadhar-Card-Entity-Extract","owner":"arnabd64","description":"A Machine Learning application to extract entities from Images of Aadhar Card.","archived":false,"fork":false,"pushed_at":"2025-06-27T05:43:05.000Z","size":59,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-23T15:42:21.379Z","etag":null,"topics":["easy-ocr","entity-extraction","object-detection","python","yolov8"],"latest_commit_sha":null,"homepage":"https://huggingface.co/arnabdhar/YOLOv8-nano-aadhar-card","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/arnabd64.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-10-15T13:48:02.000Z","updated_at":"2025-06-27T05:43:08.000Z","dependencies_parsed_at":null,"dependency_job_id":"ede8ad51-7dba-4c62-be3b-6f8341f1f586","html_url":"https://github.com/arnabd64/Aadhar-Card-Entity-Extract","commit_stats":null,"previous_names":["arnabd64/aadhar-card-entity-extract"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/arnabd64/Aadhar-Card-Entity-Extract","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arnabd64%2FAadhar-Card-Entity-Extract","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arnabd64%2FAadhar-Card-Entity-Extract/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arnabd64%2FAadhar-Card-Entity-Extract/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arnabd64%2FAadhar-Card-Entity-Extract/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/arnabd64","download_url":"https://codeload.github.com/arnabd64/Aadhar-Card-Entity-Extract/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arnabd64%2FAadhar-Card-Entity-Extract/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28544890,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-18T14:59:57.589Z","status":"ssl_error","status_checked_at":"2026-01-18T14:59:46.540Z","response_time":98,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["easy-ocr","entity-extraction","object-detection","python","yolov8"],"created_at":"2024-11-14T23:24:55.850Z","updated_at":"2026-01-18T17:33:26.487Z","avatar_url":"https://github.com/arnabd64.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Aadhar Card Entity Extraction\n\n## Overview\n\nAadhar Card is the official photo ID document in India. This project aims to build an easy to use method to extract the key information from a picture of an Aadhar Card, mainly the Aadhar Number, Name of the Person, Date of Birth and Address. This is made possible using a Text Detection model and a Text Recognition Model.\n\nThe __Text Detection__ model is tasked with detecting the four entities on an image of aadhar card and getting the location of bounding boxes for the entities.We have used the YOLOv8 model provided by [Ultralytics](https://docs.ultralytics.com/). The reason to choose YOLOv8 over some other detection model is simply the ease of use throughoout the lifecycle of the model. Ultralytics provides us a low code approach to fine-tune and deploy a YOLOv8 model. Also we want our model to have a low impact on CPU and memory so we opted for the Nano variant of the model.\n\nThe __Text Recognition__ model is tasked with identifying text that is contained inside a bounding box. YOLOv8 model provides the bounding box locations which is piped into the text recognition model where it identifies the text in each box and returns the overall output in a JSON object. example:\n\nFor the front-side, expect the following output:\n```json\n{\n    \"AADHAR_NUMBER\": \"123456789012\",\n    \"NAME\": \"John Doe\",\n    \"DATE_OF_BIRTH\": \"01-01-1997\",\n}\n```\n\nFor the back-side, expect the following output:\n```json\n{\n    \"ADDRESS\": \"Some Random Address\",\n    \"AADHAR_NUMBER\": \"123456789012\"\n}\n```\n\n## How to use\n\nThere are a two ways that you can use this model:\n\n1. Using as a __Gradio__ web app.\n2. Using as a __FastAPI__ Server.\n\n#### Run from Source Code\n\nCreate a virtual environment using `venv` or `conda` whichever you prefer. Please use Python 3.9, 3.10 or 3.11\n\nInstall dependencies\n\n```bash\n$ pip install ultralytics supervision huggingface_hub easyocr fastapi uvicorn python-multipart\n```\n\nRun the server\n\n```bash\n$ uvicorn \"src.server:server\" --host=127.0.0.1 --port=8000 --workers=4\n```\n\n#### Using Docker\n\n__Docker__\n\n```bash\n# build the image\n$ docker build -t server:latest .\n\n# run container\n$ docker run -itd --rm --name server -p 8000:8000 server:latest\n```\n\n__Docker Compose__\n\n```bash\n$ docker compose up -d\n```\n\n## Opening the Web UI\n\nOnce the FastAPI server is running, head over to `http://localhost:8000/` to open the Gradio UI.\n\n\n# Links\n\n+ Fine-Tuned Model: [Huggingface](https://huggingface.co/arnabdhar/YOLOv8-nano-aadhar-card)\n+ EasyOCR: [GitHub](https://github.com/JaidedAI/EasyOCR)\n+ Notebook used for Fine-Tuning: [Link](./Fine-Tune.ipynb)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farnabd64%2Faadhar-card-entity-extract","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Farnabd64%2Faadhar-card-entity-extract","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farnabd64%2Faadhar-card-entity-extract/lists"}