FAQ

FAQ

Short answers. Full: troubleshooting.md.

zyvor-qa: command not found

pip install -e ".[dev]"
# or
make install
which zyvor-qa

Playwright browser missing

npx playwright install --with-deps chromium
# multi-browser:
npx playwright install --with-deps

Do I need an LLM?

No for smoke (zyvor-qa test) or rule-based generate/run. Yes for zyvor-qa create (natural language).

GitHub token errors

gh auth login
# or set GITHUB_TOKEN in .env
# Needs Contents: Read (+ Pull requests: Write for PR comments)

Also set ZYVOR_PRODUCT_REPO=owner/repo (not a URL).

Login tests fail on zyvor.dev

Marketing site has no product login. Keep ENABLE_DASHBOARD_TESTS=false or point ZYVOR_BASE_URL / staging at an app that does.

Dashboard exposed without password?

Local default is open. Set DASHBOARD_PASSWORD before any network exposure. Remote deploy enables auth by default.

Self-heal changed the wrong thing?

Autofix patches selectors, not requirements. Prefer ENABLE_AUTOFIX_APPLY=false in CI; review git diff tests/.

Where are reports?

reports/qa-summary.html (+ PDF if enabled), reports/summary.json for CI, Playwright report via npm run report, history under reports/history/.

More help

Troubleshooting · Tutorials Index · Common Workflows

Related: Getting Started · Configuration.