python3-anticaptcha Knowledge Bundle
Bundle OKF 0.1 · 12 conceitos · AndreiDrang/python3-anticaptcha
Open source Repository Open in the app JSON README (API)
About
# python3-anticaptcha Knowledge Bundle
This OKF knowledge bundle documents the **python3-anticaptcha** library - a Python 3.9+ client for the AntiCaptcha paid captcha-solving service.
## Architecture Overview
* [Core Architecture](core-components/) - Shared infrastructure and base classes
* [API Contract](api-contract/) - Request/response shapes, enums, and constants
* [HTTP Transport](http-transport/) - Synchronous and asynchronous HTTP clients
* [Captcha Types](captcha-types/) - Individual captcha solver implementations
## Documentation
* [README](../README.md) - Project overview, quick start, and usage examples
* [ARCHITECTURE](../ARCHITECTURE.md) - Detailed system architecture and data flows
* [AGENTS](../AGENTS.md) - Agent operating rules and context routing
* [CONTRIBUTING](../CONTRIBUTING.md) - Contribution guidelines
## External Resources
* [AntiCaptcha API Documentation](https://anti-captcha.com/apidoc) - Official API reference
* [AntiCaptcha Website](https://getcaptcha
Details
- Kind
- OKF bundles
- Topic
- Cloud & DevOps
- Publisher
- andreidrang
- Origin
- okf_github
- Category
- dados
- Version
- 0.1
- Stars
- 163
- Forks
- 37
- Last push
- 2026-08-16T23:48:10Z
- Repository state
- ativo
- Language
- Python
- License
- MIT
- Added
- 2026-09-08 22:07:22
- Updated
- 2026-09-08 22:07:22
- Origin id
AndreiDrang/python3-anticaptcha:okf/index.md
README
# python3-anticaptcha
[](https://badge.fury.io/py/python3-anticaptcha)
[](https://badge.fury.io/py/python3-anticaptcha)
[](https://pepy.tech/project/python3-anticaptcha)
[](https://andreidrang.github.io/python3-anticaptcha/)
[](https://github.com/AndreiDrang/python3-anticaptcha/actions/workflows/test.yml)
[](https://github.com/AndreiDrang/python3-anticaptcha/actions/workflows/lint.yml)
[](https://codecov.io/gh/AndreiDrang/python3-anticaptcha)
Python 3 client library for [AntiCaptcha](https://getcaptchasolution.com/vchfpctqyz) service - solve reCAPTCHA, hCaptcha, image captchas, and more programmatically.
## Why use this library?
AntiCaptcha is a paid captcha solving service. This library provides a clean Python interface to:
- Submit captchas to AntiCaptcha's worker network
- Poll for results automatically
- Handle proxy rotation for high-volume requests
- Support both synchronous and asynchronous workflows
## Supported Captcha Types
| Type | Class | Use Case |
|------|-------|----------|
| reCAPTCHA v2 | `ReCaptchaV2` | Google reCAPTCHA V2 checkbox/invisible |
| reCAPTCHA v3 | `ReCaptchaV3` | Google reCAPTCHA V3 score-based |
| Image Captcha | `ImageToText` | Classic text-from-image captchas |
| Image Coordinates | `ImageToCoordinates` | Click-on-image captchas |
| FunCaptcha | `FunCaptcha` | Arkose Labs (formerly FunCaptcha) |
| GeeTest | `GeeTest` | Chinese GeeTest captcha |
| Turnstile | `Turnstile` | Cloudflare Turnstile |
| FriendlyCaptcha | `FriendlyCaptcha` | FriendlyCaptcha puzzles |
| Prosopo | `Prosopo` | Prosopo captcha |
| Amazon WAF | `AmazonWAF` | AWS WAF Captcha |
## Quick Start
### 1. Install
```bash
pip install python3-anticaptcha
```
### 2. Get Your API Key
1. Log into [AntiCaptcha](https://getcaptchasolution.com/vchfpctqyzclients/settings/apisetup)
2. Copy your API key from the "Setup" section
### 3. Solve a reCAPTCHA
```python
from python3_anticaptcha import ReCaptchaV2
from python3_anticaptcha.core.enum import CaptchaTypeEnm
# Basic usage (no proxy)
result = ReCaptchaV2(
api_key="YOUR_API_KEY",
captcha_type=CaptchaTypeEnm.RecaptchaV2TaskProxyless,
websiteURL="https://example.com/page-with-captcha",
websiteKey="6LeIxAKTAAAAAJ309xRj9YBN2aaaaaaaaa", # sitekey from the page
).captcha_handler()
print(result["solution"]["gRecaptchaResponse"])
```
### 4. Solve with Proxy
```python
from python3_anticaptcha import ReCaptchaV2
from python3_anticaptcha.core.enum import CaptchaTypeEnm, ProxyTypeEnm
result = ReCaptchaV2(
api_key="YOUR_API_KEY",
captcha_type=CaptchaTypeEnm.RecaptchaV2Task,
websiteURL="https://example.com/page-with-captcha",
websiteKey="6LeIxAKTAAAAAJ309xRj9YBN2aaaaaaaaa",
proxyType=ProxyTypeEnm.HTTP,
proxyAddress="123.45.67.89",
proxyPort=8080,
proxyLogin="proxy_user",
proxyPassword="proxy_pass",
userAgent="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36",
).captcha_handler()
```
### 5. Async Usage
```python
import asyncio
from python3_anticaptcha import ReCaptchaV2
from python3_anticaptcha.core.enum import CaptchaTypeEnm
async def solve():
result = await ReCaptchaV2(
api_key="YOUR_API_KEY",
captcha_type=CaptchaTypeEnm.RecaptchaV2TaskProxyless,
websiteURL="https://example.com/page-with-captcha",
websiteKey="6LeIxAKTAAAAAJ309xRj9YBN2aaaaaaaaa",
).aio_captcha_handler()
return result
result = asyncio.run(solve())
```
## Environment Variable
Set `API_KEY` to avoid passing it in code:
```bash
export API_KEY="your_api_key_here"
```
```python
# Now you can omit api_key parameter
from python3_anticaptcha import ImageToText
result = ImageToText(captcha_file="captcha.png").captcha_handler()
```
## Configuration Options
All captcha classes support these common parameters:
| Parameter | Type | Description |
|-----------|------|-------------|
| `api_key` | str | Your AntiCaptcha API key (or set `API_KEY` env var) |
| `sleep_time` | int | Seconds between result polls (default: 10) |
## Documentation
- [Full Documentation](https://andreidrang.github.io/python3-anticaptcha/) - Detailed API reference
- [AntiCaptcha Errors](https://getcaptchasolution.com/vchfpctqyzapidoc/errors) - Error code meanings
## Development
Install [uv](https://docs.astral.sh/uv/) and create the project environment with all development extras:
```bash
uv sync --all-extras
```
The Makefile provides the standard project commands:
```bash
# Run tests
make tests
# Run Ruff checks
make lint
# Build package
make build
# Build documentation
make doc
```
Ruff is the formatter and linter. To apply its safe fixes and formatting, run:
```bash
make refactor
```
## Contacts
- Telegram: [pythoncaptcha](https://t.me/pythoncaptcha)
- Email: python-captcha@pm.me
---
Love Rust? Check out [Rust-AntiCaptcha](https://crates.io/crates/rust-anticaptcha) - same API for Rust projects.