Skip to main content

A lightweight python library for solving hCaptcha challenges with selenium.

Project description

hcaptcha-solver

PyPI - Status PyPI PyPI - Downloads

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

Model Labeling Accuracy

Current Data Availability

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

hcaptcha_solver-0.2.14.tar.gz (78.5 MB view details)

Uploaded Source

Built Distribution

hcaptcha_solver-0.2.14-py3-none-any.whl (78.5 MB view details)

Uploaded Python 3

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

Hashes for hcaptcha_solver-0.2.14.tar.gz
Algorithm Hash digest
SHA256 2b75d5d8a5b903368be8e150dfd07cdac0b79666fe52d352411758fd0cf4ee3b
MD5 fc297cd08b3f4e2a980a6553f5fe5422
BLAKE2b-256 06e6646c201cac52c3453706d34d847cd5964cf09f9d34ad24d8ce6c71b2a4bf

See more details on using hashes here.

Provenance

File details

Details for the file hcaptcha_solver-0.2.14-py3-none-any.whl.

File metadata

File hashes

Hashes for hcaptcha_solver-0.2.14-py3-none-any.whl
Algorithm Hash digest
SHA256 ea80b0053e646b20678d5205a2a95e3b2ad04a967e2601fc2bb20dcd5f275da2
MD5 22609375e15e9542037a475cbc8433f1
BLAKE2b-256 7221a96301f7db6b68f15a57793bc23c4741381cd9c315e41924c3aecc29cce3

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page