OCR Captcha Router
Source code, install instructions, and full documentation: github.com/khabbazan/ocr-captcha-router
A lightweight shared-style captcha router that downloads the selected TrOCR expert on first use. Hugging Face caches downloaded experts locally, and the resolver uses a confidence and grammar-based dual-model fallback for uncertain routes.
Source models
- Router:
arkhabbazan/ocr-captcha-router - Math OCR:
arkhabbazan/ocr-math-captcha - Digit OCR:
anuashok/ocr-captcha-v3
Usage
from resolver import CaptchaResolver
resolver = CaptchaResolver.from_pretrained(
"arkhabbazan/ocr-captcha-router",
token=True,
math_confidence_threshold=0.85,
)
print(resolver.predict("captcha.jpeg"))
Keep the captcha at its original aspect ratio. The resolver pads only the
router input and leaves OCR preprocessing to each TrOCR processor. The first
request for each route downloads that expert; later requests reuse the in-memory
model and Hugging Face cache. math_confidence_threshold accepts a value
from 0.0 to 1.0; it is the minimum router probability required to choose
the math result when both expert outputs match their valid formats.