A lightweight python library for solving hCaptcha challenges with selenium.
Project description
hcaptcha-solver
a lightweight Python library for solving hCaptcha challenges with selenium and neural networks
NOTE: this package is still in early development.
If you encounter any issues or unexpected behaviours, please report them!
Installation
pip install hcaptcha-solver
Usage
from hcaptcha_solver import hcaptcha_solver
from selenium import webdriver
# setup chromedriver in english (other languages not supported yet)
options = webdriver.ChromeOptions()
options.add_experimental_option('prefs', {'intl.accept_languages': 'en,en_US'})
driver = webdriver.Chrome(options=options)
driver.get("https://accounts.hcaptcha.com/demo") # open any url with hCaptcha
# create Captcha_Solver object and solve hCaptcha
captcha_solver = hcaptcha_solver.Captcha_Solver(verbose=True)
captcha_solver.is_captcha_present(driver) # returns True
captcha_solver.solve_captcha(driver) # solves the hCaptcha
Functionality
Only V1 hCaptchas are supported - any other captcha types will be skipped.
The correct images are selected using Convolutional Neural Networks trained on labeled hCaptcha data.
The models are chosen by inspecting the captcha header, so the language has to be english in order for the matching to work. (See Issue #6)
The package features models for a handful of hCaptcha tasks. The currently available models and their labeling accuracies are visualized in the figure below. The accuracy was measured on limited data and is therefore not exact.
Functionality for V2 captchas is planned in a similar way to V1 captchas.
Current Model Labeling Performance
Current Data Availability
Contributing
If you encounter any bug, error or unexpected behaviour in general, please report them with an issue giving as much detail as possible - I will try to make this package easy-to-use for everyone.
Forks and pull requests are very welcome. You can also create issues to discuss possible changes or improvements.
To help collecting captchas, run dev/main.ipynb
and submit the results. In this notebook you can also explore the data availability and train models.
updated 15/08/2023
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file hcaptcha_solver-0.2.14.tar.gz
.
File metadata
- Download URL: hcaptcha_solver-0.2.14.tar.gz
- Upload date:
- Size: 78.5 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.4
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2b75d5d8a5b903368be8e150dfd07cdac0b79666fe52d352411758fd0cf4ee3b |
|
MD5 | fc297cd08b3f4e2a980a6553f5fe5422 |
|
BLAKE2b-256 | 06e6646c201cac52c3453706d34d847cd5964cf09f9d34ad24d8ce6c71b2a4bf |
Provenance
File details
Details for the file hcaptcha_solver-0.2.14-py3-none-any.whl
.
File metadata
- Download URL: hcaptcha_solver-0.2.14-py3-none-any.whl
- Upload date:
- Size: 78.5 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.4
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | ea80b0053e646b20678d5205a2a95e3b2ad04a967e2601fc2bb20dcd5f275da2 |
|
MD5 | 22609375e15e9542037a475cbc8433f1 |
|
BLAKE2b-256 | 7221a96301f7db6b68f15a57793bc23c4741381cd9c315e41924c3aecc29cce3 |