test-zeus-ai/testzeus-hercules

这是什么？

核心功能

• 01直接运行 Gherkin 功能文件，无需编写代码即可完成浏览器端到端测试。
• 02覆盖界面、API、安全（Nuclei）、无障碍（WCAG 2.0 至 2.2）和视觉验证。
• 03生成 JUnit XML 和 HTML 报告，并保存录像、截图和网络日志作为执行证明。
• 04通过配置为规划器、导航和辅助角色分别指定不同的大模型。
• 05支持通过 CDP 连接 BrowserBase、BrowserStack、LambdaTest 等远程浏览器。
• 06支持基于 Playwright 设备描述符的移动端模拟。

适用场景

• 用自然语言场景为复杂 Web 应用编写并自动执行回归测试。
• 通过 Docker 镜像在 CI/CD 流水线中运行浏览器测试。
• 在现有端到端测试套件中加入安全与无障碍检查。
• 让不会编程的测试人员编写并维护自动化界面测试。

快速上手

1. 1

   从 PyPI 安装 Hercules

   pip install testzeus-hercules
2. 2

   安装 Playwright 及其浏览器依赖

   playwright install --with-deps
3. 3

   为你的模型提供商设置 LLM_MODEL_NAME、LLM_MODEL_API_KEY 和 LLM_MODEL_BASE_URL 环境变量

4. 4

   对 Gherkin 功能文件运行 Hercules

   testzeus-hercules --input-file opt/input/test.feature --output-path opt/output --test-data-path opt/test_data

使用前须知

• !采用 AGPL-3.0 许可证，这是一种强 Copyleft 许可证，可能限制其在专有产品中的使用方式。
• !运行测试需要 LLM 提供商的 API 密钥或自托管模型。

标签

常见问题

testzeus-hercules 是什么？

开源 AI 测试智能体，把 Gherkin 用例自动转为端到端浏览器、API、安全、无障碍和视觉测试。 Hercules 是一个开源测试智能体，用于运行以 Gherkin 编写的端到端测试。用户用接近自然语言的 Given/When/Then 描述场景，Hercules 通过基于大模型的规划器和基于 Playwright 的浏览器导航代理执行步骤，并输出 JUnit XML 和 HTML 报告，同时保存录像、截图和网络日志作为执行证明。

testzeus-hercules 可以免费使用吗？用的什么许可证？

testzeus-hercules 以 AGPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。

testzeus-hercules 还在维护吗？

活跃维护中。testzeus-hercules 最近一次提交是在 2026年10月14日。

testzeus-hercules 适合用来做什么？

用自然语言场景为复杂 Web 应用编写并自动执行回归测试。 通过 Docker 镜像在 CI/CD 流水线中运行浏览器测试。 在现有端到端测试套件中加入安全与无障碍检查。 让不会编程的测试人员编写并维护自动化界面测试。

testzeus-hercules 怎么安装和运行？

从 PyPI 安装 Hercules: pip install testzeus-hercules 安装 Playwright 及其浏览器依赖: playwright install --with-deps 为你的模型提供商设置 LLM_MODEL_NAME、LLM_MODEL_API_KEY 和 LLM_MODEL_BASE_URL 环境变量 对 Gherkin 功能文件运行 Hercules: testzeus-hercules --input-file opt/input/test.feature --output-path opt/output --test-data-path opt/test_data

在哪里获取 testzeus-hercules？

源代码和安装说明在 GitHub 上：https://github.com/test-zeus-ai/testzeus-hercules