Metadata-Version: 2.4
Name: capx
Version: 0.1.0
Summary: reCAPTCHA v2 Image Solver using YOLO and Selenium
Author-email: Mahdi Marjani <mahdi.marjani.dev@gmail.com>
License-Expression: MIT
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 to automatically solve Google's reCAPTCHA v2 "select all squares" challenges using Selenium + YOLO.

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

## How it works
- Detects objects (cars, buses, crosswalks, etc.) in captcha images
- Clicks the correct tiles automatically
- Handles 3x3, 4x4, static and dynamic challenges

### 1. Set up a virtual environment (recommended)

```bash
python -m venv venv

# Activate it
# On Linux / macOS
source venv/bin/activate

# On Windows
venv\Scripts\activate
```

### 2. Installation

```bash
pip install git+https://github.com/mahdi-marjani/recaptcha-bypass.git
```

### 3. Usage

```python
from selenium import webdriver
from selenium.webdriver.chrome.service import Service
from webdriver_manager.chrome import ChromeDriverManager
from recaptcha_bypass import RecaptchaSolver

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

solver = RecaptchaSolver(driver)
solver.solve()  # That's it

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

Works with Firefox too — see `src/recaptcha_bypass/main.py` for examples.

Enjoy! 🚀
