File size: 4,068 Bytes
504b397 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 | # 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.
|