Skip to main content

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:

  1. The background collage goes through a YOLO model, which returns one box per direction icon (u, d, l, r, lu, ld, ru, rd).
  2. 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.
  3. 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

  1. $WULU_ICON_MODEL, if it points at an existing file
  2. <CACHE_DIR>/<FILENAME>
  3. download model_url() into CACHE_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)

Source distribution for wulu-geetest-bypass-icon 0.1.1
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)

Table of built distributions (wheels) for wulu-geetest-bypass-icon 0.1.1
File Interpreter ABI Platform Actions
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 log

Release 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 log

Security 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.

Select from 2 files

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 log

A 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.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page