Frequently Asked Questions¶

General¶

What is Quorvex AI?¶

Quorvex AI is an AI-powered test automation platform that converts natural language test specifications (written in markdown) into production-ready Playwright tests. It features a three-stage Pipeline (Plan, Generate, Heal) that explores your application with a real browser, writes validated TypeScript test code, and automatically repairs failures.

What AI providers does Quorvex AI support?¶

Quorvex AI uses the Anthropic Claude API as its primary AI provider. Supported connection methods:

Does Quorvex AI require an internet connection?¶

Yes. The AI pipeline requires access to the configured AI provider API. Playwright requires network access to the target application under test. The dashboard itself runs locally.

What is the license?¶

MIT License. Free to use, modify, and distribute for personal and commercial purposes.

System Requirements¶

Setup & Configuration¶

Can I run Quorvex AI without Docker?¶

Yes. Run make setup then make dev for local development using Python and Node.js natively. Docker is only required for production deployments, distributed K6 load testing workers, and ZAP security scanning.

How do I migrate from SQLite to PostgreSQL?¶

1. Set DATABASE_URL in .env to a PostgreSQL connection string
2. Run make db-upgrade
3. Restart the backend

Existing SQLite data is not automatically migrated.

Test Generation¶

How does the Pipeline work?¶

What happens when a generated test breaks after a UI change?¶

1. Smart Check detects existing generated code
2. Runs the existing test first
3. On failure, Healer analyzes failure, explores current page state, regenerates broken selectors
4. For stubborn failures, use --hybrid mode (up to 20 healing iterations)

How do I test applications that require authentication?¶

Use credential placeholders in specs ({{VARIABLE_NAME}}), define values in .env. Generated code uses process.env.VARIABLE_NAME.

Troubleshooting¶

Related¶

• Environment Variables
• CLI Reference