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.