{"id":23845,"library":"hcaptcha-challenger","title":"hCaptcha Challenger","description":"A Python library for solving hCaptcha challenges using multimodal large language models. Version 0.19.0 requires Python >=3.10. Development is active with irregular releases.","status":"active","version":"0.19.0","language":"python","source_language":"en","source_url":"https://github.com/QIN2DIM/hcaptcha-challenger","tags":["captcha","hcaptcha","multimodal","llm","solver"],"install":[{"cmd":"pip install hcaptcha-challenger","lang":"bash","label":"pip install"}],"dependencies":[{"reason":"Image processing for captcha images","package":"pillow","optional":true}],"imports":[{"note":"Challenger is re-exported at package level in latest versions.","wrong":"from hcaptcha_challenger.challenger import Challenger","symbol":"Challenger","correct":"from hcaptcha_challenger import Challenger"}],"quickstart":{"code":"from hcaptcha_challenger import Challenger\n\nchallenger = Challenger()\n# Solve a challenge given image paths\nresult = challenger.solve(image_paths=[\"captcha_image.png\"], task=\"image_label_binary\")\nprint(result)","lang":"python","description":"Basic usage: create a Challenger instance and call solve() with image paths and a task type."},"warnings":[{"fix":"Change keyword argument from 'images' to 'image_paths'.","message":"In version 0.19.0, the solve() method signature changed: 'image_paths' replaces the old 'images' parameter. Old code using 'images' will raise TypeError.","severity":"breaking","affected_versions":">=0.19.0"},{"fix":"Remove explicit download() calls; the library downloads models on demand.","message":"Direct model file download via challenger.download() is deprecated in favor of auto-download during solve().","severity":"deprecated","affected_versions":">=0.18.0"},{"fix":"Check supported tasks in documentation or use a try-except.","message":"The library expects specific task strings like \"image_label_binary\" or \"image_area_select\". Using an unknown task string raises a KeyError.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Use image_paths instead of images.","cause":"In version 0.19.0, the parameter was renamed from images to image_paths.","error":"TypeError: solve() got an unexpected keyword argument 'images'"},{"fix":"Ensure you have version >=0.10.0 and use 'from hcaptcha_challenger import Challenger'.","cause":"Challenger is not exported from the package if installed an older version or if installed from a non-standard source.","error":"ImportError: cannot import name 'Challenger' from 'hcaptcha_challenger'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}