PACKAGE EXPLORERView in registry

agentic-qa-maestro

PyPI

Agentic QA Maestro — fully automated testing from JIRA stories to defect management

Versions collected1

Direct dependencies19From release 0.1.0

Last observed20 Oct, 22:20 UTC

README

Version 0.1.0 documentation

Agentic QA Maestro

AI-powered QA automation that turns User stories into executed tests — no scripting required.

Give it a ticket, and it will:

Read the acceptance criteria
Generate test cases
Run them in a real browser (Playwright)
Report pass/fail results back to your ticketing system

How It Works

graph LR
    Story["🎫 User Story"] --> Analysis["📝 Requirement Analysis"]
    Analysis --> Discovery["🔍 App Discovery"]
    Discovery --> Tests["✅ Test Case Generation"]
    Tests --> Execution["🌐 Test Execution"]
    Execution --> Report["📋 Bug Reporting"]

QA Maestro runs a 6-phase pipeline:

Phase	What Happens
1. Requirement Analysis	Fetches the ticket and extracts acceptance criteria
2. App Discovery	Launches a browser, explores the live app UI, maps selectors and navigation
2.5 Knowledge Enrichment	Loads pre-recorded app flows & known selectors from `app_flows/*.yaml`
3. Test Case Generation	Combines requirements + live discovery + app knowledge to generate test cases
4. Test Execution	Runs each test case against the live app, takes screenshots as evidence
5. Bug Reporting	Files bug tickets for failures, posts a summary to the original story
6. Cleanup	Closes the browser, outputs final pass/fail status

Agents

Agent	Role
Orchestrator	Coordinates the pipeline end-to-end
JIRA Agent	Reads stories, extracts criteria, posts results, files bugs
Browser Agent	Explores the app (live discovery) and executes tests via Playwright
App Knowledge Agent	Loads pre-recorded app flows, selectors, and feature maps
Test Runner	Runs pytest suites and collects results
API Agent	Validates REST endpoints against contracts
Research Agent	Looks up documentation when needed

Get Started

pip install agentic-qa-maestro    # or: uv tool install agentic-qa-maestro
qa-maestro init                   # scaffold application.yaml, .env, and app_flows/
playwright install chromium       # required once for full browser E2E
qa-maestro --ticket PROJ-123      # run against a ticket

See the Getting Started guide for full installation, configuration, and usage instructions.

Documentation

Guide	Description
Getting Started	Full setup, configuration & first run
Architecture	System design & component details
Contributing	How to contribute

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

License

Apache-2.0 — see LICENSE for details.

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Versions 1

Collected releases

Version	Published	Direct dependencies	Open version
0.1.0	9 Jun 2026	19

Package advisories

No matching advisories collected

This describes our collected data; it is not a security assessment.

Repository

PENDING

amadeusitgroup/agentic-qa-maestro

Shared repository data · GitHub

License detected in repository: Not collected

Metadata history

Meaningful changes

Current collected state Current

Observed since 20 Oct, 22:20 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package:1522018535e1e5d10f945fd07e957a535757bc983f28cdbe240edea04272c1ab