UcelX GitHub avatar

captcha-solver

UcelX

A self-hosted, provider-agnostic toolkit that standardizes CAPTCHA solving for AI agents through local-first routing, semantic validation, and secret redaction.

Stars

10

7-day growth

No data

Forks

1

Open issues

0

License

MIT

Last updated

2026-07-27

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It solves the integration problem of hardcoded provider calls and inconsistent error handling in AI agent workflows, emphasizing security, explicit scope, and fail-closed behavior.

Who it is for

  • AI agent developers
  • Automation engineers
  • Security researchers testing authorized web applications
  • Developers integrating CAPTCHA handling into browser automation

Use cases

  • Handling CAPTCHA challenges during authorized browser automation workflows
  • Configuring fallback policies across multiple user-owned solver providers
  • Safely managing CAPTCHA tokens without leaking secrets into logs
  • Running deterministic integration tests without live CAPTCHA solving

Strengths

  • Local-first and fail-closed design with explicit fallback ordering
  • Provider-agnostic typed request/result contract with semantic validation
  • Recursive secret redaction and observability without logging sensitive data
  • Capability map with guides for Cloudflare, Turnstile, reCAPTCHA, hCaptcha, AWS WAF, and Image CAPTCHA

Considerations

  • Does not include a built-in CAPTCHA solver backend; users must provide their own solver services or APIs
  • Many challenge types (e.g., DataDome, PerimeterX, Akamai) are only on the roadmap with no live implementation
  • No guaranteed live solver for any challenge type; guides and contracts are not equivalent to working solvers

README quick start

Quick start

Description

Local-first, provider-agnostic CAPTCHA and web-challenge solver integration toolkit

Related repositories

Similar projects matched by category, topics, and programming language.

react
Featured
react GitHub avatar

react

React is a JavaScript library for building user interfaces with declarative, component-based, and cross-platform design.

Web DevelopmentFrontend Frameworks
246,741
TanStack
Featured
TanStack GitHub avatar

router

TanStack Router is a type-safe, data-driven React router with built-in caching, prefetching, and nested layouts, while TanStack Start extends it into a full-stack SSR framework.

Web DevelopmentFrontend Frameworks
14,861
yetone
Featured
yetone GitHub avatar

kill-ai-slop

Kill AI Slop is a multilingual field guide and agent skill that catalogues 33 common AI-generated design tells with interactive before-after demos, and provides a tool to scan and fix web projects.

AI & Machine LearningAI Agents
805