hcaptcha-challenger

用大模型轻松过 hCaptcha,自动化不再被卡脖子

hcaptcha-challenger 是一个利用多模态大语言模型(如 GPT-4V、Gemini、CLIP)自动解决 hCaptcha 验证码的开源 Python 库。它通过 Playwright 模拟浏览器交互,将验证码图片或任务(如点选、滑块)转化为多模态模型的输入,由模型推理出正确答案并自动完成点击或拖拽操作。该项目旨在为自动化测试、爬虫等场景提供优雅的人机验证绕过方案,核心能力包括:支持多种 hCaptcha 任务类型、与现有浏览器自动化流程无缝集成、提供简单的 API 接口。它解决了传统规则或图像识别方法难以应对动态验证码的痛点,利用 LLM 的泛化能力提升通过率。

开源 free 对话助手
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 2502
维护状态 维护中
是否开源 是
定价模式 free

项目数据

分类对话助手
开发团队QIN2DIM
所属国家
官网地址
定价模式free
价格说明开源项目,GPL-3.0许可,可自行部署使用,无付费版本。
访问状态
是否开源是
开源协议GPL-3.0
主要语言Python
技术栈/模型agent,ai-agents,captcha,captcha-solver,captcha-solving,chatgpt,clip,gemini,hcaptcha,hcaptcha-solver,llm,openai,playwright,yolo
GitHub 星标★ 2502
30天Star增速
HF 下载量
上线时间2022-02-15 00:00:00
最近更新2026-09-22 00:00:00
维护状态维护中
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-09
浏览次数2

使用教程

难度:进阶 约 15 分钟 部署方式:库/依赖 5 步

⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。

环境要求

  • Python 环境(README 未给出具体版本要求)
  • 能访问 GitHub 与 PyPI 的网络
  • 需自备多模态大模型(如 GPT-4V、Gemini、CLIP)的调用凭据
  • 需安装 Playwright 及其浏览器内核(用于模拟浏览器交互)

安装与启动步骤

  1. 1获取项目源码

    从 GitHub 克隆仓库到本地,README 项目页给出该地址,具体目录名以克隆结果为准。

    git clone https://github.com/QIN2DIM/hcaptcha-challenger.git
  2. 2进入项目目录

    切换到克隆下来的仓库根目录,后续安装与运行命令都在此目录执行。

    cd hcaptcha-challenger
  3. 3安装项目依赖

    README 未给出确切安装命令,需按仓库内 pyproject.toml/requirements 等说明安装,请先查看项目文件再执行。

  4. 4配置多模态模型凭据

    项目依赖多模态大模型完成推理,需准备好对应服务的 API Key;README 未给出具体配置项名称与格式。

  5. 5按官方文档接入

    README 指向 docs 目录下的中英文文档,安装细节与接口用法应以该文档为准。

如何确认成功

README 未提供启动或验证方式的说明,请以 docs 目录内的官方文档为准。

常见问题

Q:这个项目需要第三方打码平台吗?

A:不需要。README 明确说明不依赖任何第三方反爬/打码服务,也不依赖 Tampermonkey 脚本。

Q:支持哪些验证码类型?

A:README 表格列出了 image_label_binary 等挑战类型,并标注了可插拔资源(如 ResNet ONNX)与 Agent 能力。

Q:能用本地模型吗?

A:README 提到 ResNet ONNX 分类作为可插拔资源,同时主流程基于多模态大模型,具体组合请查阅官方文档。

Q:安装命令是什么?

A:README 节选中未给出 pip 或 conda 安装命令,请以仓库 docs 目录下的官方文档为准,不要凭猜测安装。

注意事项

  • README 明确指出不使用 Tampermonkey 脚本与第三方打码服务。
  • README 提供英文、简体中文、俄语、越南语多语言文档入口,建议优先阅读中文文档。
  • 仅凭节选内容无法确定 Python 版本、依赖包名与配置项,安装前请先阅读仓库内文档。
  • 此类验证码自动化绕过可能违反目标网站条款,请仅在合规的自动化测试场景使用。

核心亮点

  • 多模态 LLM 驱动,识别准确率高,能应对复杂图像语义任务
  • 与 Playwright 深度集成,可快速接入现有浏览器自动化脚本
  • 支持 GPT-4V、Gemini、CLIP 等多种模型,灵活切换

不足之处

  • 依赖外部大模型 API,每次调用有成本且需网络环境
  • 验证码策略更新可能导致模型失效,需持续维护
  • 文档/社区待观察

适用场景

  • 自动化测试中需要处理 hCaptcha 的 Web 应用
  • 爬虫程序绕过 hCaptcha 以获取公开数据
  • 研究多模态模型在视觉推理任务中的应用

替代项目

captcha-solver、2captcha-python、AntiCaptcha

项目介绍

hcaptcha-challenger 是计算机视觉领域的开源项目,由 QIN2DIM 开发,2022 年首次发布。

在全站 13,090 个收录项目中,它的 GitHub 星标数(2,502)位列前 30%,在计算机视觉分类中处于中上游。

近 42 天,它的 GitHub 星标从 2,462 增加到 2,502,净增 40。

项目仍在小幅维护中,最近一次代码更新于 2026-09-22。GPL-3.0许可,可自行部署使用,无付费版本。

它主要面向的使用场景是:自动化测试中需要处理hCaptcha的Web应用。同类可对比的替代方案包括 captcha-solver、2captcha-python、AntiCaptcha。

上一篇:VideoLucy

下一篇:face-emotion-recognition

同类项目推荐

modlens 开源

给纯文本编码代理装上眼睛,粘贴图片即刻获得结构化视觉证据。

The first vision plugin for DeepSeek Harness, and the vision bridge for every text-o···

★ 4019 2026-08-19
opencv 开源

开箱即用的视觉算法库,搞定图像视频处理与识别

Open Source Computer Vision Library

★ 90930 2026-08-10
OpenCVTutorials 开源

中文 OpenCV 教程,从入门到实战,边看边跑代码

OpenCV-Python4.1 中文文档

★ 1430 2026-08-20
DEIMv2 开源

用DINOv3做实时检测,又快又准,直接落地。

[DEIMv2] Real Time Object Detection Meets DINOv3

★ 2046 2026-08-14