test-zeus-ai/testzeus-hercules

O que é?

Recursos principais

• 01Executa arquivos de feature Gherkin como testes automatizados de ponta a ponta no navegador, sem precisar escrever código.
• 02Abrange UI, API, segurança (Nuclei), acessibilidade (WCAG 2.0 a 2.2) e validações visuais.
• 03Gera relatórios em XML JUnit e HTML, com vídeos, capturas de tela e logs de rede como evidências.
• 04Direciona as funções de planejamento, navegação e suporte para diferentes LLMs por meio de configuração.
• 05Conecta-se a navegadores remotos via CDP, incluindo BrowserBase, BrowserStack e LambdaTest.
• 06Oferece emulação de dispositivos móveis usando descritores de dispositivos do Playwright.

Casos de uso

• Automatizar testes de regressão de aplicações web complexas a partir de cenários descritos em linguagem simples.
• Executar testes de navegador em pipelines de CI/CD usando a imagem Docker.
• Adicionar verificações de segurança e acessibilidade a suítes de testes de ponta a ponta existentes.
• Permitir que profissionais de QA sem experiência em programação escrevam e mantenham testes automatizados de UI.

Início rápido

1. 1

   Instale o Hercules pelo PyPI

   pip install testzeus-hercules
2. 2

   Instale o Playwright e as dependências do navegador

   playwright install --with-deps
3. 3

   Defina as variáveis de ambiente LLM_MODEL_NAME, LLM_MODEL_API_KEY e LLM_MODEL_BASE_URL para o provedor do seu modelo

4. 4

   Execute o Hercules com um arquivo feature do Gherkin

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

Antes de usar

• !Licenciado sob a AGPL-3.0, uma licença de copyleft forte que pode restringir o uso em produtos proprietários.
• !Para executar testes, é necessária uma chave de API de um provedor de LLM ou um modelo auto-hospedado.

Tópicos

Perguntas frequentes

O que é testzeus-hercules?

Agente de testes de IA open source que transforma arquivos de feature Gherkin em testes automatizados de ponta a ponta para navegador, API, segurança, acessibilidade e validação visual. Hercules é um agente de testes open source que executa testes de ponta a ponta escritos em Gherkin, no formato Given/When/Then em inglês simples. Os usuários descrevem um cenário em um arquivo de feature, e o Hercules usa um planejador baseado em LLM e recursos auxiliares de navegação no navegador, construídos com Playwright, para executar as etapas. Depois, apresenta os resultados em XML JUnit e HTML, com vídeos, capturas de tela e logs de rede salvos como evidências.

testzeus-hercules é gratuito? Qual é a licença?

testzeus-hercules é open source sob a licença AGPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.

testzeus-hercules ainda é mantido?

Manutenção ativa. O último commit de testzeus-hercules foi em 14 de out. de 2026.

Para que posso usar testzeus-hercules?

Automatizar testes de regressão de aplicações web complexas a partir de cenários descritos em linguagem simples. Executar testes de navegador em pipelines de CI/CD usando a imagem Docker. Adicionar verificações de segurança e acessibilidade a suítes de testes de ponta a ponta existentes. Permitir que profissionais de QA sem experiência em programação escrevam e mantenham testes automatizados de UI.

Como instalar testzeus-hercules?

Instale o Hercules pelo PyPI: pip install testzeus-hercules Instale o Playwright e as dependências do navegador: playwright install --with-deps Defina as variáveis de ambiente LLM_MODEL_NAME, LLM_MODEL_API_KEY e LLM_MODEL_BASE_URL para o provedor do seu modelo Execute o Hercules com um arquivo feature do Gherkin: testzeus-hercules --input-file opt/input/test.feature --output-path opt/output --test-data-path opt/test_data

Onde consigo testzeus-hercules?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/test-zeus-ai/testzeus-hercules