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 29, 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 29, 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.4.0.tar.gz (150.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.4.0-py3-none-any.whl (117.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: captchakraken-2.4.0.tar.gz
  • Upload date:
  • Size: 150.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.4.0.tar.gz
Algorithm Hash digest
SHA256 5dfff4623f9dfac8b600baccb66776d819cf32266ff206fba799e47e50b5970b
MD5 c0fd59a31950b5591dd24d05d821c948
BLAKE2b-256 b434d6141d1787c34dbfa182e10e0d9d7cf89f640bb8316edb82150d1fc36a5e

See more details on using hashes here.

Provenance

The following attestation bundles were made for captchakraken-2.4.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.4.0-py3-none-any.whl.

File metadata

  • Download URL: captchakraken-2.4.0-py3-none-any.whl
  • Upload date:
  • Size: 117.0 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.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9f241f3bdcce5a1bc785f24c2dae3fc46c88ca5661f5888a5931312dbd5311a1
MD5 234828bf31bd2997678232ca6c53deef
BLAKE2b-256 3fc40c2dfc4ce86dc9f98c00ce91b8716bd555b2ccae75bd191a707f07489a96

See more details on using hashes here.

Provenance

The following attestation bundles were made for captchakraken-2.4.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

This release

2.4.0 This release

2 files

2.3.0

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