Repolode
shenhao-stu

shenhao-stu/ohmycaptcha

Самостоятельно размещаемый решатель CAPTCHA с асинхронным API в стиле YesCaptcha, автоматизацией браузера через Playwright и vision-моделями, совместимыми с OpenAI.

Open source альтернатива:YesCaptcha

Звёзды
897
Форки
276
Открытые issues
10
Последний коммит
7 месяцев назад

Что это?

OhMyCaptcha — самостоятельно размещаемый сервис для решения CAPTCHA, который предоставляет эндпоинты createTask, getTaskResult и getBalance, используемые клиентами в стиле YesCaptcha. Он создан на FastAPI и предназначен для использования в качестве стороннего решателя, совместимого с такими системами, как flow2api, ожидающими этот протокол.

Сервис обрабатывает два типа задач. Для reCAPTCHA v2/v3 (включая варианты Enterprise), hCaptcha и Cloudflare Turnstile он управляет безголовым Chromium через Playwright, чтобы получать токены. Для графических CAPTCHA и задач классификации он отправляет изображения vision-модели — локальному серверу, например SGLang или vLLM, либо удалённому эндпоинту, совместимому с OpenAI.

Задачи выполняются асинхронно и хранятся в очереди в памяти с TTL в 10 минут, поэтому результаты получают с помощью опроса. Настройки охватывают адреса эндпоинтов моделей, ограничения на число повторов и время ожидания, режим безголового браузера и клиентский ключ для аутентификации. В документации описано развёртывание на локальных машинах, Render и Hugging Face Spaces.

Ключевые возможности

  • 01Реализует эндпоинты createTask, getTaskResult и getBalance в стиле YesCaptcha.
  • 02Решает reCAPTCHA v2/v3, hCaptcha и Cloudflare Turnstile с помощью Playwright и Chromium.
  • 03Классифицирует графические CAPTCHA, например HCaptcha, reCAPTCHA v2, FunCaptcha и AWS grids, с помощью vision-модели.
  • 04Поддерживает локальные модели через SGLang или vLLM и облачные модели через API, совместимые с OpenAI.
  • 05Выполняет задачи асинхронно с получением результатов через опрос и TTL в памяти 10 минут.
  • 06Разворачивается локально с Docker, а также на Render и Hugging Face Spaces.

Сценарии использования

  • Использование в качестве бэкенда для решения CAPTCHA в flow2api и других инструментах, работающих по протоколу YesCaptcha.
  • Проверка поведения интеграции сайта с reCAPTCHA, hCaptcha или Turnstile в рамках авторизованной оценки безопасности.
  • Запуск распознавания CAPTCHA на собственной инфраструктуре вместо платного стороннего сервиса.

Быстрый старт

  1. 1

    Создайте и активируйте виртуальное окружение

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

    Установите зависимости Python

    pip install -r requirements.txt
  3. 3

    Установите браузер Chromium для Playwright

    playwright install --with-deps chromium
  4. 4

    Задайте переменные окружения модели и CLIENT_KEY, затем запустите сервер

    python main.py

Что важно знать

  • Задачи хранятся в памяти с TTL 10 минут, поэтому при перезапуске они теряются.
  • Решение с помощью браузера зависит от окружения, репутации IP-адреса и поведения целевого сайта.
  • Качество классификации изображений зависит от используемой модели компьютерного зрения.
  • Воспроизводятся не все функции коммерческих CAPTCHA-сервисов, а minScore не применяется.

Темы

Частые вопросы

Что такое ohmycaptcha?
Самостоятельно размещаемый решатель CAPTCHA с асинхронным API в стиле YesCaptcha, автоматизацией браузера через Playwright и vision-моделями, совместимыми с OpenAI. OhMyCaptcha — самостоятельно размещаемый сервис для решения CAPTCHA, который предоставляет эндпоинты createTask, getTaskResult и getBalance, используемые клиентами в стиле YesCaptcha. Он создан на FastAPI и предназначен для использования в качестве стороннего решателя, совместимого с такими системами, как flow2api, ожидающими этот протокол.
ohmycaptcha можно использовать бесплатно? Какая у него лицензия?
ohmycaptcha распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
ohmycaptcha всё ещё поддерживается?
Нет коммитов больше 6 месяцев. Последний коммит в ohmycaptcha — 9 мар. 2026 г..
Для чего можно использовать ohmycaptcha?
Использование в качестве бэкенда для решения CAPTCHA в flow2api и других инструментах, работающих по протоколу YesCaptcha. Проверка поведения интеграции сайта с reCAPTCHA, hCaptcha или Turnstile в рамках авторизованной оценки безопасности. Запуск распознавания CAPTCHA на собственной инфраструктуре вместо платного стороннего сервиса.
Как установить ohmycaptcha?
Создайте и активируйте виртуальное окружение: python -m venv .venv && source .venv/bin/activate Установите зависимости Python: pip install -r requirements.txt Установите браузер Chromium для Playwright: playwright install --with-deps chromium Задайте переменные окружения модели и CLIENT_KEY, затем запустите сервер: python main.py
Где скачать ohmycaptcha?
Исходный код и инструкции по установке — на GitHub: https://github.com/shenhao-stu/ohmycaptcha

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Самостоятельно разворачиваемый AI-шлюз с API, совместимыми с OpenAI, Claude и Gemini, который маршрутизирует запросы к разным провайдерам моделей и отслеживает ключи, квоты и расходы.

50,3 тыс.12,1 тыс.GoAGPL-3.0Обновлён вчера