HumanQA

Evidence before opinion

Know what broke.
Prove what works.

Turn one declared web journey into evidence, release risk, and a regression test.

Run your first audit Read the docs
A real HumanQA HTML report showing a blocked release and evidence-backed findings
8 reproducible findings 5 portable report formats

Validated locally on Chromium

29 unit tests 27 starter packs 5 agent skills 0 required API keys

A release decision you can reconstruct

Every definite finding connects product intent to the browser state that produced it.

  1. Declare

    Version the journey and acceptance criteria.

  2. Exercise

    Run safe browser actions against an authorized target.

  3. Collect

    Keep trace, screenshots, network, console, DOM, axe, and keyboard evidence.

  4. Decide

    Apply visible formulas and contract thresholds.

  5. Regress

    Generate a reviewed Playwright starting point.

A real HumanQA finding with reproduction, evidence links, remediation, and limitations

Findings that survive review

Stable IDs, exact reproduction, raw references, confidence, risk, suggested fixes, and uncertainty travel together.

Inspect the report contract

One narrow loop. Five useful surfaces.

The deterministic core works alone. Optional integrations remain outside the release gate.

Browser evidence

Screenshots, traces, URL history, console failures, network failures, timing, and observable DOM state.

Accessibility

Raw axe references plus bounded keyboard checks, with manual-review limits intact.

Safe by default

High-impact actions are blocked. Redaction stays on. Nothing uploads silently.

Community packs

Contributors add versioned YAML personas, journeys, heuristics, frameworks, and industry knowledge without modifying core code.

Agent-ready output

Reports and five portable skills give coding agents explicit evidence and safety contracts.

Local-first setup

Install once. Turn URLs into proof.

No hosted account, telemetry, or model key is required.

Use the short humanqa package or the official @humanqa/cli organization package.

PowerShell or shell 
npx humanqa install-browser
npx humanqa audit http://127.0.0.1:4173 --journey packs/journeys/saas-project-creation.yaml
Evidence stays on your machine by default.

Built in the open, designed for extension

Apache-2.0 licensed with clear package boundaries, data-only packs, contributor mentoring, and evidence-backed roadmap decisions.

View repository Author a pack