The project is in a healthy, maintained state
A Ruby gem that uses Tesseract OCR to extract text from UDISE captcha images. This gem helps in automating UDISE-related tasks by providing captcha reading capabilities.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
 Dependencies

Development

~> 13.0
~> 3.5

Runtime

 Project Readme

UDISE Captcha Reader

A Ruby gem for reading UDISE (Unified District Information System for Education) captcha images using OCR technology. This gem helps in automating UDISE-related tasks by providing reliable captcha reading capabilities.

Prerequisites

  • Ruby >= 2.6.0
  • Tesseract OCR engine
  • ImageMagick

Installing Prerequisites

macOS

brew install tesseract
brew install imagemagick

Ubuntu/Debian

sudo apt-get update
sudo apt-get install tesseract-ocr
sudo apt-get install imagemagick

Installation

Add this line to your application's Gemfile:

gem 'udise_captcha_reader'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install udise_captcha_reader

Usage

require 'udise_captcha_reader'

# Create a new reader instance
reader = UdiseCaptchaReader::Reader.new

# Read text from a captcha image
text = reader.read_text('path/to/captcha.jpeg')
puts text

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake test to run the tests.

To install this gem onto your local machine, run bundle exec rake install.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/UDISE-Plus/udise_captcha_reader.

License

The gem is available as open source under the terms of the MIT License.