captchakraken

The Python engine + CLI behind CaptchaKraken: OpenCV grid detection + a fine-tuned Qwen3.5-9B vision LoRA served on vLLM. Given a screenshot of a captcha grid, it locates the tiles and returns the click plan. Ships the captchakraken command.

For demo videos, accuracy numbers, the browser driver, and the full self-hosting guide, see the main repo CaptchaKraken.

Install

pip install captchakraken            # client: OpenCV detection + vLLM HTTP planner
pip install "captchakraken[serve]"   # + the serving stack (vLLM/torch) to self-host

The base install is lightweight — everything you need to solve captchas against a vLLM server (local or remote). The [serve] extra pulls the heavy stack only if you want to run the model yourself. The one-command setup.sh installs [serve], downloads the weights, and writes an env file for you.

Hands-off server

The vLLM server is managed for you. On your first solve, if the configured endpoint is local and nothing is listening, a server is started automatically and reused. Point VLLM_BASE_URL at a server you already run to skip local management entirely.

captchakraken server start | stop | status | run

Usage

# Solve an image/video: classify → find_grid → plan. Prints the click actions.
captchakraken path/to/captcha.png
captchakraken path/to/captcha.png --puzzle-source hcaptcha

from captchakraken import CaptchaSolver

solver = CaptchaSolver()          # connects to / auto-starts a local vLLM
actions = solver.solve("captcha.png")

Pure-OpenCV tool subcommands (no model): find-grid, find-checkbox, detect-selected, grid-cell-states, find-move, find-movable, and a persistent serve worker the browser driver polls.

Configuration (model-agnostic)

Everything model-specific lives in captchakraken.config and is env-overridable — the solver never hard-codes a model.

Variable Meaning Default
VLLM_BASE_URL Inference endpoint http://localhost:8000/v1
CAPTCHA_KRAKEN_API_KEY Bearer token (VLLM_API_KEY also accepted) EMPTY
CAPTCHA_BASE_MODEL Base weights vLLM loads Qwen/Qwen3.5-9B
CAPTCHA_LORA_ADAPTER Captcha adapter (HF id or path) CaptchaKraken/CaptchaKraken_v1
CAPTCHA_LORA_NAME Served adapter name the client requests captcha
CAPTCHA_KRAKEN_AUTOSTART 0 disables local auto-start 1

License

CaptchaKraken Source-Available License v1.0 — see LICENSE. Build with it (scrapers, stealth browsers, QA tooling); you may not sell the solve itself or ship a thin wrapper (browser extension, hosted solving API).

Project links

Data verified by PyPI on Jul 24, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (2.9.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for CaptchaKraken from gravatar.com CaptchaKraken

Credits

Author: Jake Writer

GitHub Statistics

Data verified by PyPI on Jul 24, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

Other/Proprietary License (CaptchaKraken Source-Available License v1.0)

Requires

Python >=3.10

Provides Extra

dev serve

Tags

automation captcha computer-vision hcaptcha qwen recaptcha vllm

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

captchakraken-2.3.0.tar.gz (140.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

captchakraken-2.3.0-py3-none-any.whl (111.1 kB view details)

Uploaded Python 3

File details

Details for the file captchakraken-2.3.0.tar.gz.

File metadata

  • Download URL: captchakraken-2.3.0.tar.gz
  • Upload date:
  • Size: 140.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for captchakraken-2.3.0.tar.gz
Algorithm Hash digest
SHA256 2ad47fcbb7ccd140e2a44f80b3d87144f4eeef54d1712408a2d1e0deb5f70db1
MD5 51eda8c0914f10e372651ca6db6e5559
BLAKE2b-256 6f0b1a0142d26c943675f4d47c9c47c0e08163a56bfe0ba5508e3153b98fe785

See more details on using hashes here.

Provenance

The following attestation bundles were made for captchakraken-2.3.0.tar.gz:

Publisher: publish.yml on JWriter20/CaptchaKraken

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file captchakraken-2.3.0-py3-none-any.whl.

File metadata

  • Download URL: captchakraken-2.3.0-py3-none-any.whl
  • Upload date:
  • Size: 111.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for captchakraken-2.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c13067c7ae1f09f0da47e7c390acd6e8eac37404310fbbda6a7eb36b82cb4695
MD5 e97e12a22c504a8848b1a6ad97c83e10
BLAKE2b-256 caef854e9df7b7f543ab32633f0c819292ae69ee6020e1754219fe437273ee6b

See more details on using hashes here.

Provenance

The following attestation bundles were made for captchakraken-2.3.0-py3-none-any.whl:

Publisher: publish.yml on JWriter20/CaptchaKraken

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

2.9.0

2 files

2.8.0

2 files

2.6.1

2 files

2.6.0

2 files

2.4.0

2 files

This release

2.3.0 This release

2 files

2.2.0

2 files

2.0.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page