Metadata-Version: 2.4
Name: capx
Version: 0.1.2
Summary: reCAPTCHA v2 Image Solver using YOLO and Selenium
Author-email: Mahdi Marjani <mahdi.marjani.dev@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/mahdi-marjani/recaptcha-bypass
Project-URL: Documentation, https://github.com/mahdi-marjani/recaptcha-bypass
Project-URL: Repository, https://github.com/mahdi-marjani/recaptcha-bypass.git
Project-URL: Issues, https://github.com/mahdi-marjani/recaptcha-bypass/issues
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy==2.2.6
Requires-Dist: opencv-python==4.12.0.88
Requires-Dist: Pillow==12.0.0
Requires-Dist: requests==2.32.5
Requires-Dist: selenium==4.39.0
Requires-Dist: ultralytics==8.3.241
Requires-Dist: webdriver-manager==4.0.2
Requires-Dist: tqdm==4.67.1
Dynamic: license-file

# reCAPTCHA v2 Image Solver

Simple Python tool that auto-solves Google's reCAPTCHA v2 "select all squares" puzzles using Selenium + YOLO.

https://github.com/user-attachments/assets/22308be7-3a90-4757-8799-b47008b32bf0

## How it works
- Spots objects (cars, buses, crosswalks, etc.) in the images
- Clicks the right tiles for you
- Works with 3x3, 4x4, static, and dynamic challenges

### 1. virtual environment (optional but recommended)
```bash
python -m venv venv
# Linux/macOS
source venv/bin/activate
# Windows
venv\Scripts\activate
```

### 2. Install
```bash
pip install capx
```

(For the latest dev version straight from GitHub:)
```bash
pip install git+https://github.com/mahdi-marjani/capx.git
```

### 3. Quick example
```python
from selenium import webdriver
from selenium.webdriver.firefox.service import Service
from webdriver_manager.firefox import GeckoDriverManager
from capx import RecaptchaSolver

driver = webdriver.Firefox(service=Service(GeckoDriverManager().install()))
driver.get("https://www.google.com/recaptcha/api2/demo")

solver = RecaptchaSolver(driver)
solver.solve()  # Done!

input("Press Enter to quit...")
driver.quit()
```

Have fun! 🚀
