Skip to content

Commit 634a11c

Browse files
committed
Update AGENTS.md
1 parent e5f24a3 commit 634a11c

1 file changed

Lines changed: 17 additions & 5 deletions

File tree

src/python3_capsolver/AGENTS.md

Lines changed: 17 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
# PYTHON3_CAPSOLVER PACKAGE
22

3-
**Generated:** 2026-01-13
3+
**Generated:** 2026-03-15
4+
**Commit:** b797332
45

56
## OVERVIEW
67
Main library package containing service-specific captcha solving implementations. Provides high-level interfaces for various captcha types (ReCaptcha, Cloudflare Turnstile, DataDome, etc.) through a unified API.
@@ -11,17 +12,19 @@ Each service class inherits from `core.CaptchaParams` and implements synchronous
1112
```
1213
src/python3_capsolver/
1314
├── core/ # Base classes, instruments, serializers
14-
├── control.py # Control class for direct API methods
15-
├── recaptcha.py # ReCaptcha V2/V3/Enterprise implementations
16-
├── cloudflare.py # Cloudflare Turnstile/Challenge solver
15+
├── control.py # Direct API access (get_balance, create_task, get_task_result)
16+
├── recaptcha.py # ReCaptcha V2/V3/Enterprise
17+
├── cloudflare.py # Cloudflare Turnstile/Challenge
1718
├── vision_engine.py # AI-based image recognition
1819
├── image_to_text.py # OCR text extraction
1920
├── datadome_slider.py # DataDome slider captcha
2021
├── mt_captcha.py # MtCaptcha solver
2122
├── gee_test.py # GeeTest solver
2223
├── aws_waf.py # AWS WAF bypass
2324
├── friendly_captcha.py # FriendlyCaptcha solver
24-
└── yandex.py # Yandex captcha solver
25+
├── yandex.py # Yandex captcha solver
26+
├── __init__.py # Exports only __version__ (minimal)
27+
└── __version__.py # Version string
2528
```
2629

2730
## WHERE TO LOOK
@@ -41,3 +44,12 @@ src/python3_capsolver/
4144
- **Task Payload**: Passed via `task_payload` dict, merged with internal task params
4245
- **Response Structure**: Returns dict with `errorId`, `taskId`, `status`, `solution` fields
4346
- **Context Managers**: Support `with` and `async with` for session cleanup
47+
48+
## ANTI-PATTERNS (THIS PACKAGE)
49+
- **Minimal `__init__.py`**: Does NOT export service classes. Users cannot do `from python3_capsolver import ReCaptcha` — must use full path `from python3_capsolver.recaptcha import ReCaptcha`
50+
- **AGENTS.md in package dir**: Will ship with distribution unless excluded in `pyproject.toml`
51+
52+
## UNIQUE STYLES
53+
- **control.py (431 lines)**: Largest file, provides raw API access without abstraction
54+
- **Service files**: 2-5k lines each, focused on single captcha type
55+
- **No type stubs**: Type hints inline, no `.pyi` files

0 commit comments

Comments
 (0)