Skip to content

Commit

Permalink
Update Readme & Requirements
Browse files Browse the repository at this point in the history
  • Loading branch information
Vinyzu committed Jan 12, 2025
1 parent dd4ba89 commit 288c73d
Show file tree
Hide file tree
Showing 2 changed files with 35 additions and 17 deletions.
48 changes: 33 additions & 15 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,19 +3,29 @@
[![](https://img.shields.io/pypi/v/recognizer.svg?color=1182C3)](https://pypi.org/project/recognizer/)
[![Downloads](https://static.pepy.tech/badge/recognizer)](https://pepy.tech/project/recognizer)

<h1 align="center">
🎭 reCognizer
</h1>


<p align="center">
<a href="https://github.com/Kaliiiiiiiiii-Vinyzu/patchright-python/releases/latest">
<img alt="Patchright Version" src="https://img.shields.io/github/v/release/microsoft/playwright-python?display_name=release&label=Version">
</a>
<a href="https://github.com/Vinyzu/recognizer/actions">
<img src="https://github.com/Vinyzu/recognizer/actions/workflows/ci.yml/badge.svg">
</a>
<a href="https://github.com/Kaliiiiiiiiii-Vinyzu/patchright-python/releases">
<img alt="GitHub Downloads (all assets, all releases)" src="https://img.shields.io/pepy/dt/patchright?color=seagreen">
</a>
<a href="https://github.com/Kaliiiiiiiiii-Vinyzu/patchright-python/blob/main/LICENSE">
<img src="https://img.shields.io/badge/License-GNU%20GPL-green">
</a>
</p>

#### reCognizer is a free-to-use AI based [reCaptcha](https://developers.google.com/recaptcha) Solver. <br> Usable with an easy-to-use API, also available for Async and Sync Playwright. <br> You can pass almost any format into the Challenger, from full-page screenshots, only-captcha images and no-border images to single images in a list.

#### Note: You Should use an undetected browser engine like [Botright](https://github.com/Vinyzu/Botright) to solve the Captchas consistently. <br> reCaptcha detects normal Playwright easily and you probably wont get any successful solves despite correct recognitions.

---

## Sponsors
[![Capsolver Banner](https://github.com/user-attachments/assets/b39e70da-3011-4743-9e87-e63947bf41b9)](https://docs.capsolver.com/?utm_source=github&utm_medium=banner_github&utm_campaign=recognizer)

[Capsolver.com](https://www.capsolver.com/?utm_source=github&utm_medium=banner_github&utm_campaign=recognizer) is an AI-powered service that specializes in solving various types of captchas automatically. It supports captchas such as [reCAPTCHA V2](https://docs.capsolver.com/guide/captcha/ReCaptchaV2.html?utm_source=github&utm_medium=banner_github&utm_campaign=recognizer), [reCAPTCHA V3](https://docs.capsolver.com/guide/captcha/ReCaptchaV3.html?utm_source=github&utm_medium=banner_github&utm_campaign=recognizer), [hCaptcha](https://docs.capsolver.com/guide/captcha/HCaptcha.html?utm_source=github&utm_medium=banner_github&utm_campaign=recognizer), [FunCaptcha](https://docs.capsolver.com/guide/captcha/FunCaptcha.html?utm_source=github&utm_medium=banner_github&utm_campaign=recognizer), [DataDome](https://docs.capsolver.com/guide/captcha/DataDome.html?utm_source=github&utm_medium=banner_github&utm_campaign=recognizer), [AWS Captcha](https://docs.capsolver.com/guide/captcha/awsWaf.html?utm_source=github&utm_medium=banner_github&utm_campaign=recognizer), [Geetest](https://docs.capsolver.com/guide/captcha/Geetest.html?utm_source=github&utm_medium=banner_github&utm_campaign=recognizer), and Cloudflare [Captcha](https://docs.capsolver.com/guide/antibots/cloudflare_turnstile.html?utm_source=github&utm_medium=banner_github&utm_campaign=recognizer) / [Challenge 5s](https://docs.capsolver.com/guide/antibots/cloudflare_challenge.html?utm_source=github&utm_medium=banner_github&utm_campaign=recognizer), [Imperva / Incapsula](https://docs.capsolver.com/guide/antibots/imperva.html?utm_source=github&utm_medium=banner_github&utm_campaign=recognizer), among others.

For developers, Capsolver offers API integration options detailed in their [documentation](https://docs.capsolver.com/?utm_source=github&utm_medium=banner_github&utm_campaign=recognizer), facilitating the integration of captcha solving into applications. They also provide browser extensions for [Chrome](https://chromewebstore.google.com/detail/captcha-solver-auto-captc/pgojnojmmhpofjgdmaebadhbocahppod) and [Firefox](https://addons.mozilla.org/es/firefox/addon/capsolver-captcha-solver/), making it easy to use their service directly within a browser. Different pricing packages are available to accommodate varying needs, ensuring flexibility for users.
#### Note: You Should use an undetected browser engine like [Patchright](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright-python) or [Botright](https://github.com/Vinyzu/Botright) to solve the Captchas consistently. <br> reCaptcha detects normal Playwright easily and you probably wont get any successful solves despite correct recognitions.

---

Expand Down Expand Up @@ -50,7 +60,7 @@ accepted_image_types = TypeVar("accepted_image_types", Path, Union[PathLike[str]
# Real Code
from recognizer import Detector

detector = Detector()
detector = Detector(optimize_click_order=True)

task_type: str = "bicycle"
images: accepted_image_types = "recaptcha_image.png"
Expand All @@ -73,7 +83,7 @@ def run(playwright: Playwright):
browser = playwright.chromium.launch()
page = browser.new_page()

challenger = SyncChallenger(page)
challenger = SyncChallenger(page, click_timeout=1000)
page.goto("https://recaptcha-demo.appspot.com/recaptcha-v2-checkbox-explicit.php")

challenger.solve_recaptcha()
Expand All @@ -99,7 +109,7 @@ async def run(playwright: Playwright):
browser = await playwright.chromium.launch()
page = await browser.new_page()

challenger = AsyncChallenger(page)
challenger = AsyncChallenger(page, click_timeout=1000)
await page.goto("https://recaptcha-demo.appspot.com/recaptcha-v2-checkbox-explicit.php")

await challenger.solve_recaptcha()
Expand All @@ -118,20 +128,28 @@ asyncio.run(main())

## Copyright and License
© [Vinyzu](https://github.com/Vinyzu/)

<br>
[GNU GPL](https://choosealicense.com/licenses/gpl-3.0/)

(Commercial Usage is allowed, but source, license and copyright has to made available. reCaptcha Challenger does not provide and Liability or Warranty)

---

## Projects/AIs Used
[YOLO11m-seg](https://github.com/ultralytics/ultralytics)
<br>
[flavour/CLIP ViT-L/14](https://huggingface.co/flavour/CLIP-ViT-B-16-DataComp.XL-s13B-b90K)
<br>
[CIDAS/clipseg](https://huggingface.co/CIDAS/clipseg-rd64-refined)
[]()

## Thanks to

[QIN2DIM](https://github.com/QIN2DIM) (For basic project structure)

---

![Version](https://img.shields.io/badge/reCognizer-v1.4-blue)
![Version](https://img.shields.io/pypi/v/reCognizer?display_name=release&label=reCognizer)
![License](https://img.shields.io/badge/License-GNU%20GPL-green)
![Python](https://img.shields.io/badge/Python-v3.x-lightgrey)

Expand Down
4 changes: 2 additions & 2 deletions requirements-test.txt
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
# This requirements are for development and testing only, not for production.
pytest~=8.3.4
pytest_asyncio~=0.25.2
pytest_asyncio~=0.24.0
pytest-rerunfailures~=15.0
mypy~=1.14.1
ruff~=0.9.1
types-setuptools~=75.8.0.20250110
botright~=0.5.1
# botright~=0.5.1
playwright~=1.49.1
patchright~=1.49.1

0 comments on commit 288c73d

Please sign in to comment.