Repolode
Enviar
test-zeus-ai

test-zeus-ai/testzeus-hercules

Agente de testing con IA y de código abierto que convierte archivos de funcionalidades Gherkin en pruebas automatizadas de extremo a extremo para navegador, API, seguridad, accesibilidad y aspectos visuales.

Alternativa open source a:TestimMabl

Ver en GitHubSitio web
Estrellas
1,192
Forks
196
Issues abiertos
44
Último commit
hace 7 días

¿Qué es?

Hercules es un agente de testing de código abierto que ejecuta pruebas de extremo a extremo escritas en Gherkin, el formato en inglés sencillo Given/When/Then. Los usuarios describen un escenario en un archivo de funcionalidades y Hercules usa un planificador basado en LLM y herramientas auxiliares de navegación por el navegador, desarrolladas sobre Playwright, para ejecutar los pasos. Después, genera resultados en JUnit XML y HTML, y guarda videos, capturas de pantalla y registros de red como evidencia.

Además de los flujos de interfaz de usuario, el proyecto abarca pruebas de API, análisis de seguridad con Nuclei, verificaciones de accesibilidad según WCAG 2.0 a 2.2 y validaciones visuales. Admite el enrutamiento de LLM por agente mediante el archivo agents_llm_config.json, incluidos los endpoints compatibles con OpenAI y los proxies de LiteLLM, y puede conectarse a navegadores remotos mediante CDP, como BrowserBase, BrowserStack y LambdaTest.

Hercules se puede instalar desde PyPI, ejecutar como imagen de Docker o compilar desde el código fuente; también puede funcionar como servidor MCP. Es posible invocar scripts personalizados de Python desde los pasos de Gherkin, con acceso a Playwright.

Funciones clave

  • 01Ejecuta archivos de funcionalidades Gherkin como pruebas automatizadas de extremo a extremo en el navegador, sin necesidad de escribir código.
  • 02Abarca validaciones de interfaz de usuario, API, seguridad (Nuclei), accesibilidad (WCAG 2.0 a 2.2) y aspectos visuales.
  • 03Genera informes JUnit XML y HTML, y guarda videos, capturas de pantalla y registros de red como evidencia.
  • 04Enruta los roles de planificación, navegación y asistencia a distintos LLM mediante configuración.
  • 05Se conecta a navegadores remotos mediante CDP, incluidos BrowserBase, BrowserStack y LambdaTest.
  • 06Admite la emulación de dispositivos móviles mediante descriptores de dispositivos de Playwright.

Casos de uso

  • Automatizar pruebas de regresión para aplicaciones web complejas a partir de escenarios en inglés sencillo.
  • Ejecutar pruebas de navegador en pipelines de CI/CD mediante la imagen de Docker.
  • Añadir verificaciones de seguridad y accesibilidad a suites de pruebas de extremo a extremo existentes.
  • Permitir que el personal de QA sin conocimientos de programación escriba y mantenga pruebas automatizadas de interfaz de usuario.

Inicio rápido

  1. 1

    Instala Hercules desde PyPI

    pip install testzeus-hercules
  2. 2

    Instala Playwright y las dependencias de su navegador

    playwright install --with-deps
  3. 3

    Configura las variables de entorno LLM_MODEL_NAME, LLM_MODEL_API_KEY y LLM_MODEL_BASE_URL para tu proveedor de modelos

  4. 4

    Ejecuta Hercules con un archivo feature de Gherkin

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

Antes de usarlo

  • Está bajo la licencia AGPL-3.0, una licencia de copyleft estricto que puede limitar su uso en productos propietarios.
  • Para ejecutar pruebas, se necesita una clave de API de un proveedor de LLM o un modelo autoalojado.

Temas

#ai-testing#test-automation#end-to-end-testing#gherkin#playwright#bdd#accessibility-testing#llm-agent#agent#agentic-ai

Preguntas frecuentes

¿Qué es testzeus-hercules?
Agente de testing con IA y de código abierto que convierte archivos de funcionalidades Gherkin en pruebas automatizadas de extremo a extremo para navegador, API, seguridad, accesibilidad y aspectos visuales. Hercules es un agente de testing de código abierto que ejecuta pruebas de extremo a extremo escritas en Gherkin, el formato en inglés sencillo Given/When/Then. Los usuarios describen un escenario en un archivo de funcionalidades y Hercules usa un planificador basado en LLM y herramientas auxiliares de navegación por el navegador, desarrolladas sobre Playwright, para ejecutar los pasos. Después, genera resultados en JUnit XML y HTML, y guarda videos, capturas de pantalla y registros de red como evidencia.
¿testzeus-hercules es gratuito? ¿Qué licencia tiene?
testzeus-hercules es open source bajo la licencia AGPL-3.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿testzeus-hercules sigue mantenido?
Mantenimiento activo. El último commit de testzeus-hercules fue el 14 oct 2026.
¿Para qué puedo usar testzeus-hercules?
Automatizar pruebas de regresión para aplicaciones web complejas a partir de escenarios en inglés sencillo. Ejecutar pruebas de navegador en pipelines de CI/CD mediante la imagen de Docker. Añadir verificaciones de seguridad y accesibilidad a suites de pruebas de extremo a extremo existentes. Permitir que el personal de QA sin conocimientos de programación escriba y mantenga pruebas automatizadas de interfaz de usuario.
¿Cómo se instala testzeus-hercules?
Instala Hercules desde PyPI: pip install testzeus-hercules Instala Playwright y las dependencias de su navegador: playwright install --with-deps Configura las variables de entorno LLM_MODEL_NAME, LLM_MODEL_API_KEY y LLM_MODEL_BASE_URL para tu proveedor de modelos Ejecuta Hercules con un archivo feature de Gherkin: testzeus-hercules --input-file opt/input/test.feature --output-path opt/output --test-data-path opt/test_data
¿Dónde consigo testzeus-hercules?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/test-zeus-ai/testzeus-hercules

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados