| # OhMyCaptcha |
|
|
| <div class="hero hero--light" markdown> |
|
|
| <div class="hero__visual"> |
| <img src="assets/ohmycaptcha-hero.png" alt="OhMyCaptcha — self-hostable captcha solving service"> |
| </div> |
|
|
| <div class="hero__copy" markdown> |
|
|
| ## ⚡ Self-hostable captcha solving with a clean YesCaptcha-style API |
|
|
| OhMyCaptcha combines **FastAPI**, **Playwright**, and **OpenAI-compatible multimodal models** into a focused service for **flow2api** and similar integrations. Supports **19 task types** across reCAPTCHA, hCaptcha, Cloudflare Turnstile, and image classification. |
|
|
| <div class="hero__actions" markdown> |
|
|
| [Get started](getting-started.md){ .md-button .md-button--primary } |
| [API reference](api-reference.md){ .md-button } |
| [GitHub](https://github.com/shenhao-stu/ohmycaptcha){ .md-button } |
|
|
| </div> |
|
|
| </div> |
|
|
| </div> |
|
|
| ## ✨ Highlights |
|
|
| <div class="grid cards feature-cards" markdown> |
|
|
| - :material-api: **YesCaptcha-style API** |
|
|
| --- |
| |
| Familiar async `createTask` / `getTaskResult` semantics covering reCAPTCHA v2/v3, hCaptcha, Turnstile, and image classification. |
| |
| - :material-google-chrome: **Browser-based solving** |
|
|
| --- |
| |
| Playwright + Chromium automate token generation for reCAPTCHA v2/v3, hCaptcha, and Cloudflare Turnstile. |
| |
| - :material-image-search: **Multimodal image recognition** |
|
|
| --- |
| |
| Route image captcha analysis through OpenAI-compatible vision models for HCaptcha, reCAPTCHA, FunCaptcha, and AWS classification. |
| |
| - :material-cloud-outline: **Self-hosted deployment** |
|
|
| --- |
| |
| Run locally or follow the included Render and Hugging Face Spaces deployment guides. |
| |
| </div> |
|
|
| ## 🧠 Supported task types |
|
|
| ### Browser-based solving (12 types) |
|
|
| | Category | Task Types | |
| |----------|-----------| |
| | **reCAPTCHA v3** | `RecaptchaV3TaskProxyless`, `RecaptchaV3TaskProxylessM1`, `RecaptchaV3TaskProxylessM1S7`, `RecaptchaV3TaskProxylessM1S9` | |
| | **reCAPTCHA v3 Enterprise** | `RecaptchaV3EnterpriseTask`, `RecaptchaV3EnterpriseTaskM1` | |
| | **reCAPTCHA v2** | `NoCaptchaTaskProxyless`, `RecaptchaV2TaskProxyless`, `RecaptchaV2EnterpriseTaskProxyless` | |
| | **hCaptcha** | `HCaptchaTaskProxyless` | |
| | **Cloudflare Turnstile** | `TurnstileTaskProxyless`, `TurnstileTaskProxylessM1` | |
|
|
| ### Image recognition (3 types) |
|
|
| | Task Type | Description | |
| |-----------|-------------| |
| | `ImageToTextTask` | Argus-inspired multimodal recognition for click, slide, and drag captchas | |
| | `ImageToTextTaskMuggle` | Text/alphanumeric image recognition | |
| | `ImageToTextTaskM1` | Async image text recognition | |
|
|
| ### Image classification (4 types) |
|
|
| | Task Type | Description | |
| |-----------|-------------| |
| | `HCaptchaClassification` | hCaptcha grid image classification | |
| | `ReCaptchaV2Classification` | reCAPTCHA v2 grid cell selection | |
| | `FunCaptchaClassification` | FunCaptcha image selection | |
| | `AwsClassification` | AWS CAPTCHA image classification | |
|
|
| ## 🚀 Quick paths |
|
|
| <div class="grid cards feature-cards" markdown> |
|
|
| - :material-rocket-launch-outline: **Quick start** |
|
|
| --- |
| |
| Install dependencies, configure environment variables, and launch the service locally. |
| |
| [Open quick start](getting-started.md) |
| |
| - :material-file-document-outline: **API reference** |
|
|
| --- |
| |
| Review all 19 supported task types, endpoints, and request formats. |
| |
| [Open API reference](api-reference.md) |
| |
| - :material-play-box-outline: **Acceptance** |
|
|
| --- |
| |
| Validate detector-target behavior and confirm token generation flow. |
| |
| [Open acceptance guide](acceptance.md) |
| |
| - :material-server-outline: **Deployment** |
|
|
| --- |
| |
| Follow the Render or Hugging Face Spaces guides for a production-facing instance. |
| |
| [Open deployment guide](deployment/render.md) |
| |
| </div> |
|
|
| ## 📌 Scope note |
|
|
| OhMyCaptcha implements a **YesCaptcha-style API surface covering 19 task types** across reCAPTCHA v2/v3, hCaptcha, Cloudflare Turnstile, and image classification. Browser-based tasks rely on Playwright automation and may require tuning for specific target sites. Image classification leverages multimodal vision models and accuracy depends on model quality. |
|
|
