Repolode
投稿する
test-zeus-ai

test-zeus-ai/testzeus-hercules

Gherkinのfeatureファイルから、ブラウザー、API、セキュリティ、アクセシビリティ、ビジュアルのE2Eテストを自動生成・実行するオープンソースのAIテストエージェント。

代替できる製品:TestimMabl

GitHub で見る公式サイト
スター
1,192
フォーク
196
未解決の Issue
44
最終コミット
7 日前

これは何？

Herculesは、平易な英語のGiven/When/Then形式で記述されたGherkinのE2Eテストを実行するオープンソースのテストエージェントです。ユーザーがfeatureファイルにシナリオを記述すると、HerculesはLLMベースのプランナーとPlaywrightを使ったブラウザーナビゲーション用ヘルパーを活用して各ステップを実行します。結果はJUnit XMLとHTMLで出力され、証跡として動画、スクリーンショット、ネットワークログも保存されます。

UIフローに加えて、APIテスト、Nucleiによるセキュリティスキャン、WCAG 2.0〜2.2のアクセシビリティチェック、ビジュアルアサーションにも対応しています。agents_llm_config.jsonファイルを使ってエージェントごとにLLMを振り分けられ、OpenAI互換のエンドポイントやLiteLLMプロキシも利用できます。また、BrowserBase、BrowserStack、LambdaTestなど、CDP経由でリモートブラウザーに接続できます。

HerculesはPyPIからインストールできるほか、Dockerイメージとして実行したり、ソースからビルドしたりできます。MCPサーバーとしての実行にも対応しています。GherkinのステップからPlaywrightを利用できるカスタムPythonスクリプトを呼び出すこともできます。

主な機能

  • 01コードを書かずに、GherkinのfeatureファイルをブラウザーのE2Eテストとして自動実行できます。
  • 02UI、API、セキュリティ（Nuclei）、アクセシビリティ（WCAG 2.0〜2.2）、ビジュアルの検証に対応しています。
  • 03証跡となる動画、スクリーンショット、ネットワークログを含むJUnit XMLおよびHTMLレポートを出力します。
  • 04設定を通じて、プランナー、ナビゲーション、ヘルパーの各役割に異なるLLMを割り当てられます。
  • 05BrowserBase、BrowserStack、LambdaTestなど、CDP経由でリモートブラウザーに接続できます。
  • 06Playwrightのデバイス記述子を使ったモバイルデバイスのエミュレーションに対応しています。

ユースケース

  • 平易な英語のシナリオをもとに、複雑なWebアプリケーションの回帰テストを自動化する。
  • 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キーまたはセルフホスト型モデルが必要です。

トピック

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

よくある質問

testzeus-hercules とは？
Gherkinのfeatureファイルから、ブラウザー、API、セキュリティ、アクセシビリティ、ビジュアルのE2Eテストを自動生成・実行するオープンソースの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 は何に使えますか？
平易な英語のシナリオをもとに、複雑なWebアプリケーションの回帰テストを自動化する。 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

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト