geetest-solver 1.0.8

GeeTest v4 ICON CAPTCHA solver using YOLO + template matching

GeeTest Solver

Python library for solving GeeTest v4 captchas (ICON and MATCH/IconCrush types).

Installation

pip install geetest-solver

Usage

Synchronous

from geetest_solver import solve_captcha

# Icon captcha (default)
seccode = solve_captcha(captcha_id="<CAPTCHA_ID>", captcha_type="icon")

# Match/IconCrush captcha
seccode = solve_captcha(captcha_id="<CAPTCHA_ID>", captcha_type="match")

# With proxy
proxies = {
    'http': 'http://user:[e-mail]:8080',
    'https': 'http://user:[e-mail]:8080'
}
seccode = solve_captcha(
    captcha_id="<CAPTCHA_ID>", 
    captcha_type="icon",
    proxies=proxies
)

Async (FastAPI, aiohttp, etc.)

from geetest_solver.async_wrapper import solve_captcha_async

# Icon captcha
seccode = await solve_captcha_async(captcha_id="<CAPTCHA_ID>", captcha_type="icon")

# Match captcha
seccode = await solve_captcha_async(captcha_id="<CAPTCHA_ID>", captcha_type="match")

# With proxy
proxies = {
    'http': 'http://user:[e-mail]:8080',
    'https': 'http://user:[e-mail]:8080'
}
seccode = await solve_captcha_async(
    captcha_id="<CAPTCHA_ID>",
    captcha_type="icon",
    proxies=proxies
)

FastAPI Example

from fastapi import FastAPI
from geetest_solver.async_wrapper import solve_captcha_async

app = FastAPI()

@app.post("/solve")
async def solve_captcha_endpoint(captcha_id: str):
    result = await solve_captcha_async(captcha_id=captcha_id)
    return {"seccode": result}

Features

• Icon captcha: YOLO-based object detection + template matching
• Match captcha: Grid-based puzzle solver (swap to match 3)
• Async support: Non-blocking execution for FastAPI/async frameworks
• Thread-safe: No matplotlib global lock issues
• Automatic retry on failure
• Proxy support
• High success rate

Captcha Types

• icon: Click icons in sequence (uses YOLO model)
• match: Swap grid items to match 3 in a row (IconCrush)

Configuration

Disable Matplotlib (default)

Matplotlib is disabled by default to avoid global lock issues in multi-threaded environments. To enable for debugging:

export ENABLE_MATPLOTLIB=1

Disable YOLO Verbose Output

import os
os.environ['YOLO_VERBOSE'] = 'False'

Requirements

• Python 3.8+
• CUDA (optional, for GPU acceleration)

License

MIT