A self-hosted captcha solver that clones the YesCaptcha API
Self-host a YesCaptcha-compatible captcha solver for reCAPTCHA, hCaptcha, and image-classification tasks using Playwright and local vision models.

What it does
OhMyCaptcha is a FastAPI service that solves captchas by driving browsers with Playwright and querying vision models. It mimics the YesCaptcha API—createTask, getTaskResult, getBalance—so existing clients can swap it in as a self-hosted replacement for commercial solvers. It covers 19 task types, from reCAPTCHA v2/v3 and hCaptcha to image-to-text and grid-classification challenges.
The interesting bit The project splits cognitive load across two models: a lightweight local multimodal model (Qwen3.5-2B via SGLang) handles image analysis, while a separate cloud model tackles trickier reasoning. Browser automation and vision inference are wrapped in a single async queue that lives entirely in memory, with tasks evaporating after ten minutes.
Key highlights
- Drop-in YesCaptcha compatibility: same
createTask/getTaskResult/getBalanceprotocol - 19 task types: browser automation for reCAPTCHA, hCaptcha, Cloudflare Turnstile, plus image classification and OCR-style recognition
- Dual-model backend: local SGLang or vLLM for images, plus any OpenAI-compatible cloud endpoint for harder tasks
- Deploys to Render, Hugging Face Spaces, or local Docker with headless Chromium
- In-memory async task queue with automatic retries
Caveats
- Tasks are stored in memory with a 10-minute TTL; there is no persistence layer
- Browser-based solving depends heavily on environment, IP reputation, and target-site behavior
minScoreis accepted for compatibility but not actually enforced
Verdict A practical DIY alternative if you want a self-hosted YesCaptcha-compatible service and are comfortable managing Playwright and local LLM inference. Look elsewhere if you need the reliability guarantees and full feature parity of a commercial solver.
Frequently asked
- What is shenhao-stu/ohmycaptcha?
- Self-host a YesCaptcha-compatible captcha solver for reCAPTCHA, hCaptcha, and image-classification tasks using Playwright and local vision models.
- Is ohmycaptcha open source?
- Yes — shenhao-stu/ohmycaptcha is open source, released under the MIT license.
- What language is ohmycaptcha written in?
- shenhao-stu/ohmycaptcha is primarily written in Python.
- How popular is ohmycaptcha?
- shenhao-stu/ohmycaptcha has 815 stars on GitHub.
- Where can I find ohmycaptcha?
- shenhao-stu/ohmycaptcha is on GitHub at https://github.com/shenhao-stu/ohmycaptcha.