Repolode
Enviar
shenhao-stu

shenhao-stu/ohmycaptcha

Solver de CAPTCHA autoalojable con una API asíncrona al estilo de YesCaptcha, que usa automatización de navegador con Playwright y modelos de visión compatibles con OpenAI.

Alternativa open source a:YesCaptcha

Ver en GitHubSitio web
Estrellas
897
Forks
276
Issues abiertos
10
Último commit
hace 7 meses

¿Qué es?

OhMyCaptcha es un servicio autoalojable para resolver CAPTCHA que ofrece los endpoints createTask, getTaskResult y getBalance que usan los clientes al estilo de YesCaptcha. Está desarrollado con FastAPI y está pensado como solver de terceros que puede sustituirse directamente por otros en sistemas como flow2api, que esperan este protocolo.

El servicio gestiona dos tipos de tareas. Para reCAPTCHA v2/v3 (incluidas las variantes Enterprise), hCaptcha y Cloudflare Turnstile, controla Chromium sin interfaz gráfica mediante Playwright para generar tokens. Para los CAPTCHA de imágenes y las tareas de clasificación, envía imágenes a un modelo de visión, ya sea un servidor local como SGLang o vLLM, o un endpoint remoto compatible con OpenAI.

Las tareas se ejecutan de forma asíncrona y se mantienen en una cola en memoria con un TTL de 10 minutos, por lo que los resultados se obtienen mediante consultas periódicas. La configuración incluye endpoints de modelos, límites de reintentos y tiempos de espera, el modo de navegador sin interfaz gráfica y una clave de cliente para la autenticación. La documentación incluye el despliegue en máquinas locales, Render y Hugging Face Spaces.

Funciones clave

  • 01Implementa los endpoints createTask, getTaskResult y getBalance al estilo de YesCaptcha.
  • 02Resuelve reCAPTCHA v2/v3, hCaptcha y Cloudflare Turnstile con Playwright y Chromium.
  • 03Clasifica CAPTCHA de imágenes como HCaptcha, reCAPTCHA v2, FunCaptcha y rejillas de AWS con un modelo de visión.
  • 04Admite modelos locales mediante SGLang o vLLM y modelos en la nube mediante API compatibles con OpenAI.
  • 05Ejecuta tareas de forma asíncrona, con consultas periódicas y un TTL de 10 minutos en memoria.
  • 06Se puede desplegar localmente con Docker o en Render y Hugging Face Spaces.

Casos de uso

  • Usarlo como backend para resolver CAPTCHA en flow2api u otras herramientas que usan el protocolo de YesCaptcha.
  • Probar el comportamiento de la integración de reCAPTCHA, hCaptcha o Turnstile de un sitio durante una evaluación de seguridad autorizada.
  • Ejecutar el reconocimiento de CAPTCHA en tu propia infraestructura en lugar de usar un servicio de terceros de pago.

Inicio rápido

  1. 1

    Crea y activa un entorno virtual

    python -m venv .venv && source .venv/bin/activate
  2. 2

    Instala las dependencias de Python

    pip install -r requirements.txt
  3. 3

    Instala el navegador Chromium de Playwright

    playwright install --with-deps chromium
  4. 4

    Configura las variables de entorno del modelo y CLIENT_KEY; después, inicia el servidor

    python main.py

Antes de usarlo

  • Las tareas se guardan en memoria con un TTL de 10 minutos, por lo que se pierden al reiniciar.
  • La resolución mediante navegador depende del entorno, la reputación de la IP y el comportamiento del sitio de destino.
  • La calidad de la clasificación de imágenes depende del modelo de visión utilizado.
  • No se replican todas las funciones de los servicios comerciales de CAPTCHA y no se aplica minScore.

Temas

#captcha#fastapi#playwright#multimodal#self-hosted#openai-compatible#recaptcha#vision-models#yescaptcha-compatible

Preguntas frecuentes

¿Qué es ohmycaptcha?
Solver de CAPTCHA autoalojable con una API asíncrona al estilo de YesCaptcha, que usa automatización de navegador con Playwright y modelos de visión compatibles con OpenAI. OhMyCaptcha es un servicio autoalojable para resolver CAPTCHA que ofrece los endpoints createTask, getTaskResult y getBalance que usan los clientes al estilo de YesCaptcha. Está desarrollado con FastAPI y está pensado como solver de terceros que puede sustituirse directamente por otros en sistemas como flow2api, que esperan este protocolo.
¿ohmycaptcha es gratuito? ¿Qué licencia tiene?
ohmycaptcha es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿ohmycaptcha sigue mantenido?
Sin commits en más de 6 meses. El último commit de ohmycaptcha fue el 9 mar 2026.
¿Para qué puedo usar ohmycaptcha?
Usarlo como backend para resolver CAPTCHA en flow2api u otras herramientas que usan el protocolo de YesCaptcha. Probar el comportamiento de la integración de reCAPTCHA, hCaptcha o Turnstile de un sitio durante una evaluación de seguridad autorizada. Ejecutar el reconocimiento de CAPTCHA en tu propia infraestructura en lugar de usar un servicio de terceros de pago.
¿Cómo se instala ohmycaptcha?
Crea y activa un entorno virtual: python -m venv .venv && source .venv/bin/activate Instala las dependencias de Python: pip install -r requirements.txt Instala el navegador Chromium de Playwright: playwright install --with-deps chromium Configura las variables de entorno del modelo y CLIENT_KEY; después, inicia el servidor: python main.py
¿Dónde consigo ohmycaptcha?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/shenhao-stu/ohmycaptcha

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados