---
id: capsolver
version: "1.0.7"
license: unclear
license_treatment: permissive
maintenance: dormant
---

# capsolver — capsolver python libary

License: permissive · Maintenance: dormant · Downloads: 155.7K/mo

## What it is and what it does

Capsolver is a thin Python wrapper around the Capsolver CAPTCHA-solving service API. It lets you submit CAPTCHA challenges (ReCaptcha, hCaptcha, FunCaptcha, Geetest, and others) to Capsolver's servers and retrieve solutions programmatically. You configure it with an API key, call the solve() method with a CAPTCHA type and parameters, and get back the solution token or text.

The package depends only on requests, making it lightweight to install. However, it is dormant—the latest release was in July 2023 and the last repository commit was in November 2024, so active maintenance is minimal. Before adopting it for production, verify that the Capsolver API and supported CAPTCHA types remain compatible with your use case.

Use it for:

- Automate testing of web applications protected by ReCaptcha, hCaptcha, or other supported CAPTCHA types.
- Build web scraping workflows that need to bypass CAPTCHA challenges on target sites.
- Integrate CAPTCHA solving into account registration or login automation scripts.
- Solve image-based CAPTCHA recognition tasks (ImageToTextTask) as part of larger automation pipelines.
- Monitor account balances and usage metrics for your Capsolver service subscription.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Capsolver is a Python client library for solving CAPTCHA challenges programmatically via the Capsolver API, supporting multiple CAPTCHA types including ReCaptcha, hCaptcha, FunCaptcha, Geetest, and others.

Yes, if you need to solve CAPTCHAs programmatically and have an active Capsolver account. The package is simple, has low install friction, and carries no known vulnerabilities. However, verify API compatibility first—dormant maintenance since mid-2023 means you should test against current Capsolver endpoints before relying on it in production.

## Install

pip install capsolver
uv add capsolver
poetry add capsolver

## Installing capsolver

Before you install: Installation is straightforward with low friction—a pure Python wheel with only requests as a runtime dependency. However, the package is dormant: the latest release was 2023-07-20 and the last commit was 2024-11-19, so maintenance is minimal.

License in practice: Licensed under MIT (permissive), so you may use, modify, and distribute the package freely in both open and closed projects, with minimal legal friction.

Quickstart:

pip install capsolver

import capsolver
capsolver.api_key = "your-api-key"
solution = capsolver.solve({
    "type": "ReCaptchaV2TaskProxyLess",
    "websiteKey": "...",
    "websiteURL": "..."
})
print(solution)

Requires a valid Capsolver API key (obtained from the Capsolver service); Python 3.6.8 or later.

Verify before relying:

- Whether the package works reliably with current versions of supported CAPTCHA services (last release was July 2023).
- Whether the Capsolver API endpoint and authentication scheme remain unchanged since the last release.
- Performance and success rate characteristics for each supported CAPTCHA type.

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: dormant
- Downloads: 155.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

captcha solving library, recaptcha solver python, hcaptcha automation, captcha api client, automated captcha bypass, geetest solver, cloudflare captcha, captcha recognition service, captcha-solving, web-automation, api-client

[View on SkillFed](https://skillfed.io/packages/capsolver) · [View on PyPI](https://pypi.org/project/capsolver/)