shenhao-stu/ohmycaptcha

O que é?

Recursos principais

• 01Implementa os endpoints createTask, getTaskResult e getBalance no estilo YesCaptcha.
• 02Resolve reCAPTCHA v2/v3, hCaptcha e Cloudflare Turnstile com Playwright e Chromium.
• 03Classifica captchas de imagem, como HCaptcha, reCAPTCHA v2, FunCaptcha e grades da AWS, usando um modelo de visão.
• 04Oferece suporte a modelos locais via SGLang ou vLLM e a modelos na nuvem por meio de APIs compatíveis com OpenAI.
• 05Executa tarefas de forma assíncrona, com consultas periódicas e TTL de 10 minutos na memória.
• 06Permite implantação local com Docker ou no Render e no Hugging Face Spaces.

Casos de uso

• Atuar como backend para resolver captchas no flow2api ou em outras ferramentas compatíveis com o protocolo YesCaptcha.
• Testar o comportamento da integração de reCAPTCHA, hCaptcha ou Turnstile de um site em uma avaliação de segurança autorizada.
• Executar o reconhecimento de captchas na sua própria infraestrutura, em vez de usar um serviço pago de terceiros.

Início rápido

1. 1

   Crie e ative um ambiente virtual

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

   Instale as dependências do Python

   pip install -r requirements.txt
3. 3

   Instale o navegador Chromium do Playwright

   playwright install --with-deps chromium
4. 4

   Defina as variáveis de ambiente do modelo e CLIENT_KEY; em seguida, inicie o servidor

   python main.py

Antes de usar

• !As tarefas são armazenadas na memória com um TTL de 10 minutos e, por isso, são perdidas ao reiniciar.
• !A resolução pelo navegador depende do ambiente, da reputação do IP e do comportamento do site de destino.
• !A qualidade da classificação de imagens depende do modelo de visão utilizado.
• !Nem todos os recursos dos serviços comerciais de CAPTCHA são reproduzidos, e minScore não é aplicado.

Tópicos

Perguntas frequentes

O que é ohmycaptcha?

Solucionador de captchas auto-hospedável com API assíncrona no estilo YesCaptcha, usando automação de navegador com Playwright e modelos de visão compatíveis com OpenAI. OhMyCaptcha é um serviço auto-hospedável para resolver captchas que expõe os endpoints createTask, getTaskResult e getBalance usados por clientes no estilo YesCaptcha. Desenvolvido com FastAPI, ele foi pensado para funcionar como um solucionador de terceiros substituto em sistemas como flow2api, que esperam esse protocolo.

ohmycaptcha é gratuito? Qual é a licença?

ohmycaptcha é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

ohmycaptcha ainda é mantido?

Sem commits há mais de 6 meses. O último commit de ohmycaptcha foi em 9 de mar. de 2026.

Para que posso usar ohmycaptcha?

Atuar como backend para resolver captchas no flow2api ou em outras ferramentas compatíveis com o protocolo YesCaptcha. Testar o comportamento da integração de reCAPTCHA, hCaptcha ou Turnstile de um site em uma avaliação de segurança autorizada. Executar o reconhecimento de captchas na sua própria infraestrutura, em vez de usar um serviço pago de terceiros.

Como instalar ohmycaptcha?

Crie e ative um ambiente virtual: python -m venv .venv && source .venv/bin/activate Instale as dependências do Python: pip install -r requirements.txt Instale o navegador Chromium do Playwright: playwright install --with-deps chromium Defina as variáveis de ambiente do modelo e CLIENT_KEY; em seguida, inicie o servidor: python main.py

Onde consigo ohmycaptcha?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/shenhao-stu/ohmycaptcha