quorvex_ai

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 36 Open GitHub ↗

Convert plain English test specs into self-healing Playwright tests using AI. Browser exploration, auto-fix, load/security/API/LLM testing. Open source.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">Quorvex AI</h1>
 
 Self-hosted AI testing agents that turn specs, PRDs, and app exploration into validated Playwright tests.
 
 
 Generate code your team can inspect, commit, and run in CI without a runtime AI dependency.
 
 
 <a href="https://github.com/NihadMemmedli/quorvex_ai/actions/workflows/ci.yml"><img src="https://github.com/NihadMemmedli/quorvex_ai/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
 <a href="https://github.com/NihadMemmedli/quorvex_ai/actions/workflows/docs.yml"><img src="https://github.com/NihadMemmedli/quorvex_ai/actions/workflows/docs.yml/badge.svg" alt="Docs"></a>
 <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT"></a>
 <a href="https://www.python.org/downloads/"><img src="https://img.shields.io/badge/Python-3.10+-3776AB.svg?logo=python&logoColor=white" alt="Python 3.10+"></a>
 <a href="https://nodejs.org/"><img src="https://img.shields.io/badge/Node.js-20+-339933.svg?logo=nodedotjs&logoColor=white" alt="Node.js 20+"></a>
 <a href="https://playwright.dev/"><img src="https://img.shields.io/badge/Playwright-tested-45ba4b.svg?logo=playwright&logoColor=white" alt="Playwright"></a>
 <a href="https://www.docker.com/"><img src="https://img.shields.io/badge/Docker-ready-2496ED.svg?logo=docker&logoColor=white" alt="Docker"></a>
 
 
 <a href="https://nihadmemmedli.github.io/quorvex_ai/">Documentation</a> &nbsp;&bull;&nbsp;
 <a href="https://nihadmemmedli.github.io/quorvex_ai/tutorials/getting-started/">Getting Started</a> &nbsp;&bull;&nbsp;
 <a href="docs/tutorials/examples.md">Examples</a> &nbsp;&bull;&nbsp;
 <a href="CONTRIBUTING.md">Contributing</a> &nbsp;&bull;&nbsp;
 <a href="SUPPORT.md">Support</a>

---

Quorvex AI is a self-hosted testing platform for teams that want AI-assisted test authoring without giving up normal Playwright ownership. Describe a user flow, import a PRD or OpenAPI file, or let an agent explore a real app; Quorvex plans the flow, generates Playwright TypeScript, validates it in a browser, and repairs selector or timing failures when it can.

The output is ordinary repository code. You can review it, commit it, run it in CI, and keep running it later without model calls.

![Quorvex AI product flow](https://raw.githubusercontent.com/NihadMemmedli/quorvex_ai/main/docs/assets/ui/product-flow.gif)

## Why It Matters

- **AI speed, standard test code**: agents help plan, generate, validate, and heal tests while your team keeps readable Playwright files.
- **Self-hosted by design**: app URLs, credentials, traces, recordings, and test data stay inside infrastructure you control.
- **Coverage beyond UI happy paths**: grow from E2E generation into API, load, security, database, mobile, LLM evaluation, PRD coverage, and autonomous discovery.
- **Operational surface included**: dashboard, queues, browser pool, schedules, credentials, artifacts, RBAC, CI gates, TestRail, Jira, and backup paths.

## Quick Start

All useful modes require AI provider credentials. Copy the relevant environment file, set the provider token, and run `make check-env` before relying on generated output.

| Path | Best for | Command |
|------|----------|---------|
| Evaluator demo | Fastest local product trial with the lightweight SQLite stack | `docker compose -f docker-compose.minimal.yml up -d` |
| Contributor dev | Full Docker development stack with dashboard, queues, storage, VNC, and frontend hot reload | `make dev` |
| Production/company | Compose app behind company DNS/TLS/nginx in external-nginx mode | `make start` |

Evaluator path:

```bash
git clone https://github.com/NihadMemmedli/quorvex_ai.git
cd quorvex_ai
cp .env.example .env
# Edit .env with your AI provider credentials.
make check-env
docker compose -f docker-compose.minimal.yml up -d
```

Contributor path:

```bash
git clone https://github.com/NihadMemmedli/quorvex_ai.git
cd quorvex_ai
cp .env.prod.example .env.prod
# Edit .env.prod with your AI provider credentials.
make check-env
make dev
```

Open the dashboard at [http://localhost:3000](http://localhost:3000).

For production or company-network deployments, use `.env.prod`, keep real secrets out of Git, run `make start`, and put company DNS/TLS/nginx in front of the Compose app. The repo-managed nginx container is a legacy opt-in path, not the default company deployment mode. See [On-Premises Deployment](docs/guides/company-deployment.md).

## Open In A Cloud Dev Environment

These links start a browser-based development workspace, but they do not provide AI credentials. Add your provider token in the workspace environment before running generation flows.

[![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/NihadMemmedli/quorvex_ai)
[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/NihadMemmedli/quorvex_ai?quickstart=1)

## From Spec To Playwright

Input spec:

```markdown
# Test: Login Form Validation

## Steps
1. Navigate to https://the-internet.herokuapp.com/login
2. Enter "tomsmith" into the Username field
3. Enter "SuperSecretPassword!" into the Password field
4. Click the "Login" button
5. Verify the page displays "Secure Area" heading
6. Click the "Logout" button
```

Generated output:

```ts
import { test, expect } from '@playwright/test';

test('logs in with valid credentials and logs out', async ({ page }) => {
  await page.goto('https://the-internet.herokuapp.com/login');
  await page.getByLabel('Username').fill('tomsmith');
  await page.getByLabel('Password').fill('SuperSecretPassword!');
  await page.getByRole('button', { name: 'Login' }).click();
  await expect(page.getByRole('heading', { name: 'Secure Area' })).toBeVisible();
  await page.getByRole('link', { name: 'Logout' }).click();
});
```

See the maintained [examples index](docs/tutorials/examples.md) for UI, API, authenticated-flow, generated-output, and specialized-testing examples.

## Feature Map

| Area | What Quorvex supports |
|------|------------------------|
| Test generation | Plain-English specs to Playwright, browser-backed planning, validation, Smart Check reuse, hybrid healing, visual regression, reusable `@include` templates |
| PRD and coverage | PRD upload, feature extraction, requirements generation, duplicate detection, RTM, gap analysis, suggested tests |
| Autonomous agents | App discovery, live browser state, generated task artifacts, recurring missions, long-running workflows, approval gates |
| Specialized testing | OpenAPI/API tests, K6 load tests, quick/Nuclei/ZAP security scans, database checks, mobile smoke flows, LLM evaluations |
| Quality intelligence | Regression batches, flaky test detection, pass-rate trends, failure classification, analytics, generated reports |
| Operations | Project isolation, RBAC, encrypted credentials, browser pools, Redis queues, MinIO storage, backups, schedules, GitHub/GitLab integration |

![Quorvex AI dashboard overview](https://raw.githubusercontent.com/NihadMemmedli/quorvex_ai/main/docs/assets/ui/dashboard-overview.png)

## Documentation

Full documentation is published at [nihadmemmedli.github.io/quorvex_ai](https://nihadmemmedli.github.io/quorvex_ai/).

| Need | Start here |
|------|------------|
| First successful run | [Getting Started](docs/tutorials/getting-started.md) |
| Choose a setup path | [Setup Options](docs/guides/setup-options.md) |
| Browse maintained examples | [Curated Examples](docs/tutorials/examples.md) |
| Configure environment variables | [Environment Variables](docs/reference/environment-variables.md) |
| Understand architecture | [System Overview](docs/explanation/system-overview.md) |
| Deploy behind company nginx | [On-Premises Deployment](docs/guides/company-deployment.md) |
| Troubleshoot operations | [Troubleshooting](docs/guides/troubleshooting.md) |

To browse docs locally:

```bash
pip install -r requirements-docs.txt
mkdocs serve
```

## Project Health

- Bugs, questions, support expectations: [SUPPORT.md](SUPPORT.md)
- Security reporting and supported versions: [SECURITY.md](SECURITY.md)
- Maintainer and review expectations: [MAINTAINERS.md](MAINTAINERS.md)
- Release checklist and versioning: [RELEASE.md](RELEASE.md)
- Changelog: [CHANGELOG.md](CHANGELOG.md)

## Contributing

Pull requests are welcome when they include a clear risk summary, tests run, and any docs drift. Start with [CONTRIBUTING.md](CONTRIBUTING.md), the [good first issues guide](docs/community/good-first-issues.md), and the project-specific pull request template.

## License

Quorvex AI is released under the [MIT License](LICENSE).

quorvex_ai

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README