What is Venomva?

Venomva is an all-in-one test automation platform that combines a powerful CLI with a professional Web Dashboard. It uses AI to generate tests, manage test cases, track coverage, detect defects, and integrate with your favorite tools.

npm install -g venomva
cd your-test-project
venomva

Key Features

Test Automation

• Test Explorer — Discover and browse all test files in your project
• Test Runner — Execute tests with real-time streaming output
• Results & Reporting — Detailed results with pass/fail breakdown, screenshots, videos
• Script Mapping & Sync — Map test scripts to test cases, track sync status
• Schedules — Schedule automated test runs (cron-based)
• CI/CD Integration — Jenkins, GitHub Actions, GitLab CI, Azure Pipelines
• Self-Healing — Auto-detect and fix broken selectors

Test Management

• Test Cases — Create, organize, and manage test cases with folders, tags, and versioning
• Test Plans & Cycles — Plan test execution, create cycles, track progress
• AI Test Generation — Generate test cases from requirements, NLP, JIRA tickets, or existing scripts
• Sources — Centralized hub for requirements, documents, and JIRA tickets
• Coverage — Requirements traceability, document-centric mapping, orphan detection
• Analytics — Dashboards, health scores, automation usage statistics
• Defect Management — Professional defect tracking with Kanban board, rich text, attachments

AI-Powered

• AI Assistant — Chat-based AI for test creation, debugging, and analysis
• AI Test Generation — Generate from requirements, NLP, source code, or reverse-engineer from scripts
• Automation Script Generation — Create working automation scripts from manual test cases using existing project code
• Quality Scoring — AI-powered test case quality assessment
• Gap Analysis — Identify missing test coverage
• Duplicate Detection — Find redundant test cases

Integrations & Connectors

• JIRA — Pull stories, push defects, link test cases, sync status
• Email — Send test reports and failure alerts (Gmail, Outlook, Yahoo)
• Slack — Post test results and notifications to channels
• MS Teams — Send adaptive cards with test results
• Cloud Providers — BrowserStack, LambdaTest, Sauce Labs
• Webhooks — Custom integrations via HTTP webhooks
• Import/Export — TestRail, Zephyr, Xray, PractiTest, qTest, CSV, JSON

Frameworks Supported

• Playwright (TypeScript, JavaScript)
• Cypress (TypeScript, JavaScript)
• Selenium (Java, Python, JavaScript)
• Jest / Mocha / Vitest
• Any framework with CLI output

Quick Start

Install

npm install -g venomva

Run CLI

cd your-test-project
venomva

This opens the interactive CLI where you can:

venomva > /run                    # Run all tests
venomva > /run tests/login.spec.ts  # Run specific test
venomva > /ui                     # Open web dashboard
venomva > /ai                     # AI assistant chat
venomva > /results                # View test results
venomva > help                    # See all commands

Open Web Dashboard

From the CLI:

venomva > /ui

Or directly:

venomva serve --port 3700

Open browser: http://localhost:3700

Dashboard Screenshots

The web dashboard provides a professional interface for:

• Dashboard — Overview of test health, recent runs, and key metrics
• Test Explorer — Browse and run test files with syntax highlighting
• Test Management — CRUD for test cases with folders, tags, version history
• Test Plans — Create plans, cycles, and execute tests step-by-step
• AI Test Gen — Generate test cases from multiple sources using AI
• Coverage — Traceability matrix, requirement mapping, gap detection
• Analytics — Charts, trends, health scores, automation usage
• Defects — Kanban board with full defect lifecycle management
• Connectors — JIRA, Slack, Email, Teams integration
• Settings — LLM providers, themes, user management

AI Configuration

Venomva uses LLM providers for AI features. Configure in the CLI or dashboard:

Supported Providers

| Provider | Models | Setup | |---|---|---| | OpenAI | GPT-4o, GPT-4o-mini | Set OPENAI_API_KEY env var | | Anthropic | Claude Sonnet, Claude Opus | Set ANTHROPIC_API_KEY env var | | Google | Gemini 2.0 Flash | Set GOOGLE_API_KEY env var | | xAI | Grok | Set XAI_API_KEY env var | | Ollama | Any local model | Install Ollama, no key needed |

# Set your preferred provider
export OPENAI_API_KEY=sk-your-key-here

# Or for Anthropic
export ANTHROPIC_API_KEY=sk-ant-your-key-here

Deployment

Option 1: Direct (Development/Local)

venomva serve --host 0.0.0.0 --port 3700

Option 2: Docker

venomva deploy docker

One command that:

• Creates Docker container
• Mounts your test project
• Starts Venomva dashboard
• Available at http://localhost:3700

Option 3: Production (Docker + Nginx + HTTPS)

venomva deploy production --domain venomva.yourcompany.com

Sets up:

• Docker container
• Nginx reverse proxy
• Free SSL certificate (Let's Encrypt)
• Available at https://venomva.yourcompany.com

Docker Manual

docker run -d \
  --name venomva \
  -p 3700:3700 \
  -v /path/to/your/test-project:/project \
  -e OPENAI_API_KEY=sk-your-key \
  venomva/dashboard:latest

CLI Commands

| Command | Description | |---|---| | venomva | Start interactive CLI | | venomva serve | Start headless server (API + Dashboard) | | venomva serve --port 3700 | Specify port | | venomva serve --host 0.0.0.0 | Listen on all interfaces | | venomva deploy docker | Deploy with Docker | | venomva deploy production | Deploy with Docker + Nginx + SSL | | venomva deploy status | Check deployment status | | venomva deploy stop | Stop deployment | | venomva deploy logs | View deployment logs | | venomva --version | Show version | | venomva --help | Show help |

Interactive CLI Commands

| Command | Description | |---|---| | /ui | Open web dashboard in browser | | /results | View latest test results | | /git | Git status and operations | | help | Show all available commands |

Project Structure

Venomva works with any test project. It auto-detects:

your-test-project/
├── tests/                  # Test files (auto-discovered)
├── page-objects/           # Page objects (analyzed by AI)
├── playwright.config.ts    # Framework config (auto-detected)
├── .venomva/               # Venomva data (auto-created)
│   ├── venomva.db          # SQLite database
│   ├── config.json         # Project config
│   └── results/            # Test run results
└── package.json

System Requirements

| Requirement | Minimum | Recommended | |---|---|---| | Node.js | 20.0.0 | 22+ | | RAM | 2 GB | 4 GB | | Disk | 500 MB | 2 GB | | OS | Windows 10+, macOS 12+, Ubuntu 20.04+ | Latest | | Docker (for deploy) | 20.10+ | Latest |

Environment Variables

| Variable | Description | Required | |---|---|---| | OPENAI_API_KEY | OpenAI API key | For AI features | | ANTHROPIC_API_KEY | Anthropic API key | Alternative AI | | GOOGLE_API_KEY | Google AI API key | Alternative AI | | XAI_API_KEY | xAI API key | Alternative AI | | VENOMVA_PORT | Dashboard port (default: 3700) | No | | VENOMVA_HOST | Dashboard host (default: localhost) | No | | VENOMVA_DEFAULT_PROVIDER | Default LLM provider | No |

FAQ

Q: Does Venomva modify my test files? A: Only when you explicitly ask AI to generate or fix tests. All changes require your approval.

Q: Where is data stored? A: In .venomva/ directory inside your test project. SQLite database, config, and results.

Q: Can I use it without AI? A: Yes! Test runner, management, and dashboard work without any AI provider. AI features are optional.

Q: Is my data sent to the cloud? A: Only AI prompts go to your configured LLM provider (OpenAI/Anthropic/etc). All other data stays local.

Q: Can multiple users access the dashboard? A: Yes! Use venomva serve --host 0.0.0.0 for network access, or venomva deploy docker for team deployment.

Q: Which browsers does it support? A: The dashboard works in Chrome, Firefox, Safari, and Edge. Test execution uses your project's configured browser.

License

MIT

Support

• Issues: GitHub Issues
• Documentation: docs.venomva.io