wulu-geetest-bypass-icon
Offline icon-type solver for Geetest v4 CAPTCHAs. Locates the background collage icon that matches each question and returns normalized click coordinates.
How it works
The icon CAPTCHA shows a collage background built from the same icons that
appear as questions, which makes it a matching problem rather than a
recognition one:
- The background collage goes through a YOLO model, which returns one box per
direction icon (
u,d,l,r,lu,ld,ru,rd). - Each question thumbnail is MD5-hashed. That digest is the CDN filename of the
asset, so it maps straight to a direction via
DIR_HASHES— no image comparison involved. - The question is answered with the center of the first still-unused detection facing that direction.
A question with an unknown MD5, or whose direction has no detection, raises
UnsupportedQuestionError instead of guessing.
Model
The default model is a YOLOv8n ONNX export: input 640x640, output
[1, 12, 8400], 8 direction classes. It is not trained here — both the ONNX file
and the DIR_HASHES table come from
gaogzhen/GeekedTest under the MIT License.
See THIRD_PARTY_NOTICES.md.
Lookup order
$WULU_ICON_MODEL, if it points at an existing file<CACHE_DIR>/<FILENAME>- download
model_url()intoCACHE_DIR
The model also downloads on first use. To prefetch it, run the main package's CLI:
wulu-geetest download icon
If huggingface.co is unreachable, point HF_ENDPOINT at a mirror — the same
variable huggingface_hub reads, so anything already configured for it works
here too:
export HF_ENDPOINT=https://hf-mirror.com
wulu-geetest download icon
--endpoint is shorthand for setting that variable for the one command:
wulu-geetest download icon --endpoint https://hf-mirror.com
download_model(progress=None, *, force=False) is registered under the
wulu_geetest_bypass.downloads entry point group, which is how that command finds
it; call it directly to download without the framework.
Environment variables
| Variable | Meaning | Default |
|---|---|---|
WULU_ICON_MODEL |
Path to the ONNX model. Ignored if the file does not exist. | unset → cache, then download |
WULU_ICON_DIRECTIONS |
Comma-separated channel order. Used only when the model carries no names metadata. |
u,d,l,r,lu,ld,ru,rd |
WULU_ICON_CONF_THRES |
Confidence threshold. | 0.10 |
WULU_ICON_IOU_THRES |
NMS IoU threshold. | 0.45 |
WULU_ICON_MAX_DET |
Max boxes kept per background. | 4 |
HF_ENDPOINT |
Base URL the model is downloaded from; set it to a mirror when huggingface.co is unreachable. Read on each download, so it may be set after import. |
https://huggingface.co |
Source constants (_config.py)
For downstream forks that ship their own model:
| Constant | Meaning | Default |
|---|---|---|
FILENAME |
Model filename; also its name inside the cache dir. | icon_t1_261010 |
OWNER, HF_REPO |
HuggingFace repo holding the model. | wulu007, gt |
DEFAULT_ENDPOINT |
Host used when HF_ENDPOINT is unset. |
https://huggingface.co |
model_url() |
{endpoint}/{OWNER}/{HF_REPO}/resolve/main/{FILENAME}. |
— |
CACHE_DIR |
Where the model is cached. | platformdirs.user_cache_dir('wulu-geetest-bypass', appauthor=False) |
DIR_HASHES |
Question-icon MD5 → direction. | 8 CDN assets |
Class order
Read from the model's names metadata when present, so a retrained model with a
different class order works with no configuration. Otherwise
WULU_ICON_DIRECTIONS (or its default) is used.
Either way the result must be a permutation of the eight known directions, or
the first detection raises UnsupportedModelError — as does a model exported
with end2end=True (built-in NMS). The output channel count must equal
4 + len(classes); anything else raises too.
Usage
uv add wulu-geetest-bypass[icon]
The solver registers as an entry point of the wulu_geetest_bypass.solvers
group under the icon captcha type, and is discovered automatically by
wulu_geetest_bypass.
from wulu_geetest_bypass import Geetest
solver = Geetest(captcha_id='your_captcha_id', risk_type='icon')
seccode = await solver.resolve()
Metadata
Release files for wulu-geetest-bypass-icon 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| wulu_geetest_bypass_icon-0.1.1.tar.gz | 8.0 kB | With provenance | Details for wulu_geetest_bypass_icon-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| wulu_geetest_bypass_icon-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for wulu_geetest_bypass_icon-0.1.1-py3-none-any.whl |
Total release size: 17.6 kB
Release files / wulu_geetest_bypass_icon-0.1.1.tar.gz
| Download URL | wulu_geetest_bypass_icon-0.1.1.tar.gz |
|---|---|
| Size | 8.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
26f8a05de4ab6201a0c9e45beb3c42ddd3a36149e816a66a37c8a8704403c508
|
|
BLAKE2b-256 checksum How to use checksums |
e319fe475776348be4e7450f3ce0a4709e6675be09ca2caab09320777f66416d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 31, 2026.
Transparency logRelease files / wulu_geetest_bypass_icon-0.1.1-py3-none-any.whl
| Download URL | wulu_geetest_bypass_icon-0.1.1-py3-none-any.whl |
|---|---|
| Size | 9.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b02053a3198e971c2d55500beefceec3decfc10e1aad38ed9b0946f55a410cbc
|
|
BLAKE2b-256 checksum How to use checksums |
54983c93d164ae5267dbbb42d52fe313d4efc4ecde5941fbd95914d15bee6cb6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 31, 2026.
Transparency logSecurity for wulu-geetest-bypass-icon 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for wulu_geetest_bypass_icon-0.1.1.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 31, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.