# captchaforge
> Automatic CAPTCHA detection + multi-strategy solver for
> headless browsers (Cloudflare Turnstile, reCAPTCHA v2/v3,
> hCaptcha, image grids, audio, sliders, PoW).
captchaforge is a Rust library + CLI + HTTP service for solving
CAPTCHA challenges programmatically. It ships:
- **17 production solvers** spanning the major WAF + CAPTCHA
vendors.
- **158 community detection rules** covering most public WAFs.
- **Network-layer challenge replay** for Cloudflare interstitials
(no chromium needed for the PoW path).
- **JA3 / JA4-Foxio / Akamai-H2 / Peet-H2 fingerprint catalogue**
with 12 named stealth profiles.
- **Pattern store + fingerprint LRU** that learns per-domain +
per-stack which solver wins.
- **Default-deny CORS + bearer-token auth + per-IP rate limit**
on the HTTP API.
- **Bench / property / proptest / chaos / integration test
matrix** (40+ test suites).
## Three ways to use it
```rust,ignore
// As a library:
let chain = captchaforge::solver::CaptchaSolverChain::default_chain();
let info = captchaforge::detect::detect(&page).await?;
let out = chain.solve(&page, &info).await;
```
```bash
# As a CLI:
captchaforge solve https://example.com/
```
```bash
# As an HTTP service:
captchaforge serve --port 8080
curl -X POST localhost:8080/solve -d '{"url":"https://example.com/"}'
```
## Where to start
- [Install](getting-started/install.md) — pick CLI / library /
container / Helm / Python / Node / WASM.
- [Solver chain](architecture/chain.md) — what runs in what order.
- [Bypass scorecard](project/scorecard.md) — real-world numbers.