OSS探訪ページ内ナビ
概要
TestZeus Herculesは自然言語に近いGherkin scenarioを入力に、LLM agentとPlaywrightを使ってWeb applicationを操作するtesting frameworkです。UIだけでなくAPI、security、accessibility、visual validationも対象にし、実行結果をHTML/JUnitやscreenshot・video・network logとして残せます。
特徴と向いている用途
公式資料に基づく紹介・実機未検証 · 内容確認日：
主な特徴
Gherkin scenarioからagentがbrowser操作を実行する
BDD形式のtest stepを入力し、Playwrightを使って実際のWeb UIを操作します。selectorをすべてtest codeへ固定する方式とは異なり、agentによる判断をtest executionへ組み込みます。
出典：[2]
実行結果とproof artifactをtest単位で保存する
run guideではHTML/XML結果、agent log、screenshots、videos、network logsをoutput/proofs配下へ分けて保存するproject構造が説明されています。
出典：[3]
Python sandboxで複雑なtest処理を補完する
標準Gherkinだけでは足りない場合、custom Python scriptからPlaywrightへアクセスし、条件分岐やdata processingを含む処理を追加できます。
出典：[2]
向いている用途
UI変更が多いWeb applicationのE2E test maintenanceを減らしたい場合に向く
business scenarioをGherkinとして残しつつ、browser操作の一部をagentへ任せたいQA automationやCI pipelineの比較対象になります。
出典：[2]
導入前の確認
LLM providerへ渡すtest contextとcredentialを確認する
実行にはmodel/API keyまたはagent別LLM configが必要です。production dataや認証情報を使うtestでは、configured providerへ渡すcontextとsecret管理を事前に確認します。
出典：[3]
v1.0.2で追加されたtelemetry内容を確認する
1.0.2 release noteにはtelemetryでfolder pathをcaptureし、collection内容をdocumentする変更が記載されています。機密性の高いtest environmentではtelemetry設定と送信dataを確認します。
出典：[4]
AGPL-3.0のnetwork利用・改変時の条件を確認する
HerculesはAGPL-3.0です。改変版をnetwork経由で提供する場合を含め、利用形態に応じたsource code提供条件を確認します。
出典：[5]
参考にした公式資料
- [1]test-zeus-ai/testzeus-hercules repository(2026-10-01)
- [2]TestZeus Hercules README(2026-10-01)
- [3]TestZeus Hercules run guide(2026-10-01)
- [4]TestZeus Hercules 1.0.2 release(2026-10-01)
- [5]TestZeus Hercules AGPL-3.0 license(2026-10-01)
編集部からの補足
固定selectorを大量に保守する代わりに、Gherkinの意図からagentがbrowser actionを組み立てるtesting frameworkです。LLM providerへ渡すtest context、実ブラウザの副作用、1.0.2で追加されたtelemetryの扱いを確認してからCIへ組み込みます。
3ステップで試す
- 1
Herculesを導入
Python 3.11〜3.13環境へPyPI packageをインストールします。
python -m pip install testzeus-hercules - 2
browser runtimeとtest projectを用意
Playwrightのbrowser依存を導入し、run guideのsingle-test構成を作ります。実行前にGherkin featureをopt/inputへ配置します。
playwright install --with-deps && mkdir -p opt/input opt/output opt/test_data - 3
LLM設定を指定してtestを実行
利用するLLM providerを指定してtestを実行します。CIではAPI keyをsecret storeから渡し、production credentialや機密test dataの扱いを確認します。
testzeus-hercules --project-base=opt --llm-model <model> --llm-model-api-key <api-key>
成長
成長の推移 · 直近30日
1,174 Stars
推移データを蓄積中です。
開発アクティビティ
直近90日・週次
- Commit（直近30日）
- 0
- Open PR
- 20
開発アクティビティを蓄積中です。
Built with
カテゴリとタグ
GitHubデータ
関連情報
関連記事を投稿するこのOSSの使い方や活用事例をMarkdownで投稿できます。管理者が承認した後に公開されます。
あわせて探訪
- LangChain147,365 Stars
共通タグ 3件 · 共通カテゴリ 1件 · 同じ言語
model・tool・retrieval・middlewareを組み合わせてagentを構築するPython framework
Python - Crawl4AI84,635 Stars
共通タグ 3件 · 共通カテゴリ 1件 · 同じ言語
browser renderingしたWebをLLM-ready Markdown/JSONへ変換するPython crawler
Python - Khoj37,550 Stars
共通タグ 3件 · 共通カテゴリ 1件 · 同じ言語
文書・Web・local/cloud LLMをRAG・Agent・Automationへまとめるpersonal AI
Python - PipesHub3,804 Stars
共通タグ 3件 · 共通カテゴリ 1件 · 同じ言語
source systemの権限をquery時に保ったまま、社内知識をSearch・RAG・MCPへ供給する
Python - Lightpanda35,680 Stars
共通タグ 3件 · 共通カテゴリ 1件
AIによるWeb操作のためにブラウザー本体を作り直す
Zig - LlamaIndex52,383 Stars
共通タグ 3件 · 同じ言語
データ取込、検索、RAG、AIエージェントを部品から組み立てる
Python
情報の誤りを報告
掲載内容に誤りや古い情報があればお知らせください。