geetest-solver 1.0.8__tar.gz

geetest_solver-1.0.8/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

geetest_solver-1.0.8/MANIFEST.in

@@ -0,0 +1,3 @@
+include captcha_solver/best.pt
+include README.md
+include LICENSE

geetest_solver-1.0.8/PKG-INFO

@@ -0,0 +1,128 @@
+Metadata-Version: 2.1
+Name: geetest_solver
+Version: 1.0.8
+Summary: GeeTest v4 ICON CAPTCHA solver using YOLO + template matching
+Home-page: https://github.com/syncrain/geetest-solver
+Author: kv
+License: UNKNOWN
+Platform: UNKNOWN
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Provides-Extra: interactive
+License-File: LICENSE
+
+# GeeTest Solver
+
+Python library for solving GeeTest v4 captchas (ICON and MATCH/IconCrush types).
+
+## Installation
+
+```bash
+pip install geetest-solver
+
+```
+
+## Usage
+
+### Synchronous
+
+```python
+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:pass@proxy.example.com:8080',
+    'https': 'http://user:pass@proxy.example.com:8080'
+}
+seccode = solve_captcha(
+    captcha_id="<CAPTCHA_ID>", 
+    captcha_type="icon",
+    proxies=proxies
+)
+```
+
+### Async (FastAPI, aiohttp, etc.)
+
+```python
+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:pass@proxy.example.com:8080',
+    'https': 'http://user:pass@proxy.example.com:8080'
+}
+seccode = await solve_captcha_async(
+    captcha_id="<CAPTCHA_ID>",
+    captcha_type="icon",
+    proxies=proxies
+)
+```
+
+### FastAPI Example
+
+```python
+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:
+
+```bash
+export ENABLE_MATPLOTLIB=1
+```
+
+### Disable YOLO Verbose Output
+
+```python
+import os
+os.environ['YOLO_VERBOSE'] = 'False'
+```
+
+## Requirements
+
+- Python 3.8+
+- CUDA (optional, for GPU acceleration)
+
+## License
+
+MIT
+
+

geetest_solver-1.0.8/README.md

@@ -0,0 +1,113 @@
+# GeeTest Solver
+
+Python library for solving GeeTest v4 captchas (ICON and MATCH/IconCrush types).
+
+## Installation
+
+```bash
+pip install geetest-solver
+
+```
+
+## Usage
+
+### Synchronous
+
+```python
+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:pass@proxy.example.com:8080',
+    'https': 'http://user:pass@proxy.example.com:8080'
+}
+seccode = solve_captcha(
+    captcha_id="<CAPTCHA_ID>", 
+    captcha_type="icon",
+    proxies=proxies
+)
+```
+
+### Async (FastAPI, aiohttp, etc.)
+
+```python
+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:pass@proxy.example.com:8080',
+    'https': 'http://user:pass@proxy.example.com:8080'
+}
+seccode = await solve_captcha_async(
+    captcha_id="<CAPTCHA_ID>",
+    captcha_type="icon",
+    proxies=proxies
+)
+```
+
+### FastAPI Example
+
+```python
+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:
+
+```bash
+export ENABLE_MATPLOTLIB=1
+```
+
+### Disable YOLO Verbose Output
+
+```python
+import os
+os.environ['YOLO_VERBOSE'] = 'False'
+```
+
+## Requirements
+
+- Python 3.8+
+- CUDA (optional, for GPU acceleration)
+
+## License
+
+MIT

geetest_solver-1.0.8/geetest_solver/__init__.py

@@ -0,0 +1,6 @@
+from .solver import solve_captcha
+from .hybrid_solver import load_geetest_captcha, generate_w_parameter, submit_verify_request
+from .iconcrush_solver import iconcrush_solve_all, generate_w_parameter_iconcrush
+
+__version__ = "1.0.0"
+__all__ = ["solve_captcha", "load_geetest_captcha", "generate_w_parameter", "submit_verify_request", "iconcrush_solve_all", "generate_w_parameter_iconcrush"]

geetest_solver-1.0.8/geetest_solver/async_wrapper.py

@@ -0,0 +1,25 @@
+"""Async wrapper for geetest_solver"""
+import asyncio
+from concurrent.futures import ThreadPoolExecutor
+from functools import partial
+
+_executor = ThreadPoolExecutor(max_workers=4)
+
+async def solve_captcha_async(captcha_id=None, captcha_type="icon", max_attempts=999, 
+                               interactive=False, proxies=None, verbose=False):
+    """Async wrapper for solve_captcha that runs in thread pool"""
+    from geetest_solver.solver import solve_captcha
+    
+    loop = asyncio.get_event_loop()
+    func = partial(
+        solve_captcha,
+        captcha_id=captcha_id,
+        captcha_type=captcha_type,
+        max_attempts=max_attempts,
+        interactive=interactive,
+        proxies=proxies,
+        verbose=verbose
+    )
+    
+    result = await loop.run_in_executor(_executor, func)
+    return result