Getting Started

Getting Started

Install Zyvor QA Agent and run your first smoke suite. Deep: Tutorial 01 · README.

Prerequisites

• Python 3.10+ (3.11+ recommended)
• Node.js 20+
• Git
• Optional: LLM API key, gh CLI for GitHub specs

Install

git clone https://github.com/hypersdk/ZyAIQAAgent.git
cd ZyAIQAAgent
cp .env.example .env
# Minimum:
# ZYVOR_BASE_URL=https://zyvor.dev

make install
# → pip install -e ".[dev]", npm install, Playwright Chromium

First smoke (no LLM)

zyvor-qa test --grep @smoke
# or
zyvor-qa test

Against public demo with video/HAR: Tutorial 13.

Full local pipeline

zyvor-qa run --source local
open reports/qa-summary.html
# Interactive Playwright report:
npm run report

Container (v0.4.0+)

docker pull ghcr.io/hypersdk/zyaiqaagent:latest
docker run --rm --env-file .env ghcr.io/hypersdk/zyaiqaagent:latest test --grep @smoke
docker run --rm -p 8080:8080 --env-file .env \
  ghcr.io/hypersdk/zyaiqaagent:latest serve --port 8080 --host 0.0.0.0
# → http://localhost:8080/dashboard

Mission Control

zyvor-qa serve --port 8080
open http://localhost:8080/dashboard

See Mission Control.

Next

1. CLI Commands
2. Test Authoring — specs & GitHub
3. Tutorials index (15 guides)