System Requirements
This page lists the minimum and recommended specifications for running xyva.ai.
Operating System
| OS | Minimum Version | Notes |
|---|---|---|
| Windows | 10 (build 1903+) | Windows 11 recommended |
| macOS | 12 Monterey | Universal binary (Intel + Apple Silicon) |
| Linux | Ubuntu 20.04 / Debian 11 | Other distros supported via AppImage |
Hardware
| Component | Minimum | Recommended |
|---|---|---|
| RAM | 4 GB | 8 GB or more |
| Disk Space | 500 MB (app only) | 2 GB+ (app + Playwright browsers + projects) |
| CPU | Dual-core x64 | Quad-core or better |
| Display | 1280 x 720 | 1920 x 1080 or higher |
TIP
Swarm QA runs multiple AI agents concurrently. For large scans with 5+ agents, 8 GB RAM is strongly recommended.
Software Dependencies
| Dependency | Required Version | Purpose |
|---|---|---|
| Node.js | 18.0+ | Test execution, dependency resolution |
| Git | 2.30+ | Project import, version control features |
| npm | 8.0+ (ships with Node) | Package management |
Verify your environment:
bash
node --version # Should print v18.x or higher
git --version # Should print 2.30 or higher
npm --version # Should print 8.x or higherPlaywright Browsers
Playwright browser binaries are optional but required for running tests:
bash
# Install all browsers (~500 MB)
npx playwright install
# Install only Chromium (~200 MB)
npx playwright install chromiumBrowser disk space breakdown
- Chromium: ~200 MB
- Firefox: ~250 MB
- WebKit: ~150 MB
- Total with all browsers: ~600 MB
Network Requirements
| Feature | Network Access Required |
|---|---|
| Test execution (local) | No |
| AI features (Brain, Swarm) | Yes — outbound HTTPS to AI provider |
| CI/CD integration | Yes — GitLab/GitHub API access |
| Auto-update | Yes — xyva.ai release server |
| Checkmk monitoring | Yes — Checkmk REST API |
WARNING
If your organization uses a corporate proxy or firewall, configure proxy settings under Settings > Proxy & Network before enabling AI or CI/CD features. See Proxy Settings.
Optional: WireGuard VPN
Private deployments can use WireGuard to connect to self-hosted services (AI proxy, internal GitLab, monitoring). A WireGuard client must be installed separately:
- Windows: WireGuard for Windows
- macOS: Available via App Store or Homebrew (
brew install wireguard-tools) - Linux:
sudo apt install wireguard
Next Steps
- Installation — Download and set up xyva
- Quick Start — Your first test run