Registry / llm-agents / hcaptcha-challenger

hcaptcha-challenger

library0.19.0pypypiunverified

A Python library for solving hCaptcha challenges using multimodal large language models. Version 0.19.0 requires Python >=3.10. Development is active with irregular releases.

llm-agents ai-ml auth-security

pip install hcaptcha-challenger

github ↗package ↗docs ↗changelog ↗

INSTALL

IMPORT

SIG · HCAPTCHA-CHALLENGE

hcaptcha-challenger

llm-agentspythonv0.19.0

Install

20.3s avg

Import

—

Disk

591MB

Pass rate

5/ 10

Env Coverage5 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.19.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

build_error

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 20.3s · import 0.000s · 568MB

591MB installed

● package 591MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Challenger

✓ from hcaptcha_challenger import Challenger

✗ from hcaptcha_challenger import Challenger

Basic usage: create a Challenger instance and call solve() with image paths and a task type.

from hcaptcha_challenger import Challenger challenger = Challenger() # Solve a challenge given image paths result = challenger.solve(image_paths=["captcha_image.png"], task="image_label_binary") print(result)

Debug

Known issues

breakingIn version 0.19.0, the solve() method signature changed: 'image_paths' replaces the old 'images' parameter. Old code using 'images' will raise TypeError.

fix

Change keyword argument from 'images' to 'image_paths'.

affects: >=0.19.0

deprecatedDirect model file download via challenger.download() is deprecated in favor of auto-download during solve().

fix

Remove explicit download() calls; the library downloads models on demand.

affects: >=0.18.0

gotchaThe library expects specific task strings like "image_label_binary" or "image_area_select". Using an unknown task string raises a KeyError.

fix

Check supported tasks in documentation or use a try-except.

affects: all

Upgrade

Version history

0.19.0latest on PyPI · released Dec 21, 2025

Audit

Dependencies

pillowoptionalImage processing for captcha images

Agent activity

33 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/QIN2DIM/hcaptcha-challenger ↗

packagehttps://pypi.org/project/hcaptcha-challenger/ ↗

docshttps://github.com/QIN2DIM/hcaptcha-challenger ↗

changeloghttps://github.com/QIN2DIM/hcaptcha-challenger/blob/master/CHANGELOG.md ↗