mrafieefard/hcaptchasolver

This project is a distributed system for automatically solving hCaptcha challenges. hCaptcha is a security check that websites display to confirm a visitor is a real person, typically a grid of images where you pick the ones matching a prompt. This tool automates that process and returns the token that the website expects after a human completes the challenge. The system has two parts that talk to each other. The first is a Python backend server that receives solve requests over a standard web API. You send it the site key and URL of the page showing the captcha, along with an optional proxy address, and the backend queues the request and waits for a result. The second part is a desktop application built with Electron that runs on one or more machines. Each desktop app connects to the backend over a persistent WebSocket connection, receives solve tasks, opens an embedded browser view to actually work through the captcha, and sends the resulting token back to the backend. This distributed design means you can run multiple desktop workers on different machines and they all feed into the same backend queue. The backend tracks how many workers are connected and how many are available at any moment via a status endpoint. The README contains setup instructions for both parts. The backend requires Python and a small set of dependencies. The desktop app requires Node.js and can be built for Linux, Windows, or macOS. There is no additional documentation beyond what the README provides.