test-zeus-ai/testzeus-hercules

어떤 프로젝트인가요?

핵심 기능

• 01코드를 작성하지 않고 Gherkin feature 파일을 자동화된 브라우저 E2E 테스트로 실행합니다.
• 02UI, API, 보안(Nuclei), 접근성(WCAG 2.0~2.2) 및 시각적 검증을 지원합니다.
• 03증빙 자료인 동영상, 스크린샷, 네트워크 로그와 함께 JUnit XML 및 HTML 보고서를 생성합니다.
• 04설정을 통해 플래너, 탐색, 도우미 역할에 서로 다른 LLM을 연결합니다.
• 05BrowserBase, BrowserStack, LambdaTest 등을 포함한 원격 브라우저에 CDP로 연결합니다.
• 06Playwright 기기 설명자를 사용한 모바일 기기 에뮬레이션을 지원합니다.

활용 사례

• 일반 영어 시나리오를 바탕으로 복잡한 웹 애플리케이션의 회귀 테스트를 자동화합니다.
• Docker 이미지를 사용해 CI/CD 파이프라인에서 브라우저 테스트를 실행합니다.
• 기존 E2E 테스트 스위트에 보안 및 접근성 검사를 추가합니다.
• 코딩하지 않는 QA 담당자가 자동화된 UI 테스트를 작성하고 유지 관리할 수 있도록 합니다.

빠른 시작

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 feature 파일에서 Hercules를 실행합니다

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

사용 전 알아둘 점

• !강한 카피레프트 라이선스인 AGPL-3.0에 따라 제공되며, 독점 제품에서의 사용이 제한될 수 있습니다.
• !테스트를 실행하려면 LLM 제공업체의 API 키 또는 자체 호스팅 모델이 필요합니다.

토픽

자주 묻는 질문

testzeus-hercules은(는) 무엇인가요?

Gherkin feature 파일을 자동화된 브라우저 E2E, API, 보안, 접근성 및 시각 테스트로 변환하는 오픈 소스 AI 테스트 에이전트입니다. Hercules는 일반 영어로 작성하는 Given/When/Then 형식인 Gherkin으로 만든 E2E 테스트를 실행하는 오픈 소스 테스트 에이전트입니다. 사용자가 feature 파일에 시나리오를 작성하면 Hercules는 LLM 기반 플래너와 Playwright를 기반으로 한 브라우저 탐색 도우미를 사용해 단계를 수행합니다. 그런 다음 결과를 JUnit XML 및 HTML로 보고하고, 증빙 자료로 동영상, 스크린샷, 네트워크 로그를 저장합니다.

testzeus-hercules은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

testzeus-hercules은(는) AGPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

testzeus-hercules은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. testzeus-hercules의 마지막 커밋은 2026년 10월 14일입니다.

testzeus-hercules은(는) 어디에 사용할 수 있나요?

일반 영어 시나리오를 바탕으로 복잡한 웹 애플리케이션의 회귀 테스트를 자동화합니다. Docker 이미지를 사용해 CI/CD 파이프라인에서 브라우저 테스트를 실행합니다. 기존 E2E 테스트 스위트에 보안 및 접근성 검사를 추가합니다. 코딩하지 않는 QA 담당자가 자동화된 UI 테스트를 작성하고 유지 관리할 수 있도록 합니다.

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 feature 파일에서 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