Repolode
test-zeus-ai

test-zeus-ai/testzeus-hercules

Опенсорсный AI-агент для тестирования, который превращает Gherkin feature-файлы в автоматизированные сквозные тесты браузера, API, безопасности, доступности и визуального интерфейса.

Open source альтернатива:TestimMabl

Звёзды
1,192
Форки
196
Открытые issues
44
Последний коммит
7 дней назад

Что это?

Hercules — опенсорсный агент для тестирования, который выполняет сквозные тесты, написанные на Gherkin — формате на простом английском языке со структурами Given/When/Then. Пользователь описывает сценарий в feature-файле, а Hercules использует планировщик на базе LLM и помощники для навигации в браузере, построенные на Playwright, чтобы выполнить шаги. Затем он формирует отчёты в JUnit XML и HTML, а видео, скриншоты и сетевые логи сохраняет в качестве подтверждений.

Помимо пользовательских сценариев в UI, проект поддерживает тестирование API, сканирование безопасности с помощью Nuclei, проверки доступности по WCAG 2.0–2.2 и визуальные проверки. Для разных ролей агента можно настроить маршрутизацию запросов к LLM через файл agents_llm_config.json, в том числе к совместимым с OpenAI endpoint и прокси LiteLLM. Также можно подключаться к удалённым браузерам по CDP, например BrowserBase, BrowserStack и LambdaTest.

Hercules можно установить из PyPI, запускать как Docker-образ или собрать из исходного кода; кроме того, он может работать как MCP-сервер. Из шагов Gherkin можно вызывать пользовательские скрипты на Python, которые получают доступ к Playwright.

Ключевые возможности

  • 01Запускает Gherkin feature-файлы как автоматизированные сквозные тесты браузера без написания кода.
  • 02Проверяет UI, API, безопасность (Nuclei), доступность (WCAG 2.0–2.2) и визуальное представление.
  • 03Формирует отчёты в JUnit XML и HTML, а видео, скриншоты и сетевые логи сохраняет в качестве подтверждений.
  • 04Позволяет через конфигурацию направлять задачи планировщика, навигации и вспомогательных ролей разным LLM.
  • 05Подключается к удалённым браузерам по CDP, включая BrowserBase, BrowserStack и LambdaTest.
  • 06Поддерживает эмуляцию мобильных устройств с помощью дескрипторов устройств Playwright.

Сценарии использования

  • Автоматизация регрессионного тестирования сложных веб-приложений на основе сценариев на простом английском языке.
  • Запуск браузерных тестов в CI/CD-пайплайнах с помощью Docker-образа.
  • Добавление проверок безопасности и доступности в существующие сквозные наборы тестов.
  • Возможность для QA-специалистов без навыков программирования писать и поддерживать автоматизированные UI-тесты.

Быстрый старт

  1. 1

    Установите Hercules из PyPI

    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

    Запустите Hercules с Gherkin-файлом feature

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

Что важно знать

  • Распространяется по лицензии AGPL-3.0 — лицензии с сильным копилефтом, которая может ограничивать использование в проприетарных продуктах.
  • Для запуска тестов необходим API-ключ поставщика LLM или модель, размещённая на собственном сервере.

Темы

Частые вопросы

Что такое testzeus-hercules?
Опенсорсный AI-агент для тестирования, который превращает Gherkin feature-файлы в автоматизированные сквозные тесты браузера, API, безопасности, доступности и визуального интерфейса. Hercules — опенсорсный агент для тестирования, который выполняет сквозные тесты, написанные на Gherkin — формате на простом английском языке со структурами Given/When/Then. Пользователь описывает сценарий в feature-файле, а Hercules использует планировщик на базе LLM и помощники для навигации в браузере, построенные на Playwright, чтобы выполнить шаги. Затем он формирует отчёты в JUnit XML и HTML, а видео, скриншоты и сетевые логи сохраняет в качестве подтверждений.
testzeus-hercules можно использовать бесплатно? Какая у него лицензия?
testzeus-hercules распространяется с открытым исходным кодом под лицензией AGPL-3.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.
testzeus-hercules всё ещё поддерживается?
Активно поддерживается. Последний коммит в testzeus-hercules — 14 окт. 2026 г..
Для чего можно использовать testzeus-hercules?
Автоматизация регрессионного тестирования сложных веб-приложений на основе сценариев на простом английском языке. Запуск браузерных тестов в CI/CD-пайплайнах с помощью Docker-образа. Добавление проверок безопасности и доступности в существующие сквозные наборы тестов. Возможность для QA-специалистов без навыков программирования писать и поддерживать автоматизированные UI-тесты.
Как установить testzeus-hercules?
Установите Hercules из PyPI: pip install testzeus-hercules Установите Playwright и зависимости браузера: playwright install --with-deps Задайте переменные окружения LLM_MODEL_NAME, LLM_MODEL_API_KEY и LLM_MODEL_BASE_URL для своего поставщика моделей Запустите Hercules с Gherkin-файлом feature: 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

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты