# test-zeus-ai/testzeus-hercules

Hercules is the world’s first open-source testing agent, enabling UI, API, Security, Accessibility, and Visual validations – all without code or maintenance. Automate testing effortlessly and let Hercules handle the heavy lifting! ⚡

Repository: https://github.com/test-zeus-ai/testzeus-hercules
Canonical: https://ross.abutalabs.com/products/testzeus-hercules
Homepage: https://testzeus.com/hercules
Language: Python
License: AGPL-3.0
License Family: copyleft
Topics: ai, autogen, automation, browser, end-to-end-testing, hercules, large-action-model, playwright, rpa, testing, testzeus, agents, qa-automation, software-testing, test-automation, testing-tools, agent, agentic-ai
Last push: 2026-08-04T09:37:17+00:00

## Health v2 (maintenance only)
Score: 86/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 96, release rhythm 96, longevity 46
- inputs: {"age_days": 657, "days_push": 29, "days_rel": 30, "gap_med": 3.0, "n_releases_24m": 53}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1128, forks 183 (observed 2026-08-28T04:03:41.673664+00:00)

## What it is
Hercules is an open-source AI testing agent that turns Gherkin feature files into fully automated end-to-end tests covering UI, API, security, accessibility, and visual validations without writing code. It is built in Python on top of Playwright and agent frameworks, and can run locally via pip or Docker or in CI/CD pipelines.

## Use cases
- automate end-to-end web tests from Gherkin feature files without coding
- run UI, API, accessibility, and visual regression checks in one pass
- add AI-driven test automation to a CI/CD pipeline
- test Salesforce UI flows using natural language
- let non-engineers write and run automated QA tests in plain English
- replace brittle Playwright or Selenium script maintenance with an autonomous agent

## When to choose
- you want codeless, natural-language (Gherkin) end-to-end test automation
- your team lacks dedicated QA automation engineers but needs reliable e2e coverage
- you need combined UI, API, security, accessibility, and visual testing in a single tool
- you test complex platforms like Salesforce that are hard to script with traditional frameworks

## When to avoid
- you need fully deterministic, fast, low-cost tests with no LLM dependency
- your project requires a permissive license (Hercules is AGPL-3.0)
- you need fine-grained low-level control over every test step and selector
- you cannot send test data through AI agent processing due to compliance constraints

## Facets
- artifact type: framework
- maturity: active
- function: testing, e2e-testing, agent-framework, workflow-automation, web-scraping
- domain: testing, web-development, developer-tools
- platform: python, cross-platform, cli
- tags: test-automation, gherkin, bdd, playwright, qa, agentic-testing, no-code-testing, accessibility-testing, visual-testing, api-testing, security-testing, salesforce-testing, ci-cd, automation, ai-agents, docker

## Member repositories
- test-zeus-ai/testzeus-hercules (main) score 86

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:41.673664+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:38:44.481187+00:00, confidence not recorded.
  - readme: https://github.com/test-zeus-ai/testzeus-hercules (fetched 2026-08-28T04:03:41.673664+00:00, sha 17de129ebe08)
  - homepage: https://testzeus.com/hercules (fetched 2026-08-29T12:43:17.789357+00:00, sha cdb291014630)
  - site_page: https://testzeus.com/pricing (fetched 2026-08-29T12:43:17.799229+00:00, sha 15176cf8b01a)
  - site_page: https://testzeus.com/ (fetched 2026-08-29T12:43:17.801787+00:00, sha 022a9a7d1401)
- Data as of 2026-08-30T08:39:29.467469+00:00.