System Requirements
xyva.ai is split into a browser portal (no install) and a local Node.js agent (one command). Requirements are listed for both.
Portal (browser)
| Component | Supported |
|---|---|
| Browser | Chrome 120+, Edge 120+, Firefox 121+, Safari 17+ |
| Connection | HTTPS to xyva.ai and a few outbound origins for AI provider calls (your keys, your endpoints) |
| Display | 1280 × 720 minimum, 1920 × 1080 recommended |
The portal works on any OS that runs a modern browser, including ChromeOS and Linux distributions where the local agent is unavailable. Without the agent the portal is read-only — you can review past runs but not execute new ones.
Local Agent (Node.js)
| Component | Minimum | Recommended |
|---|---|---|
| OS | Windows 10 (build 1903+), macOS 12, Ubuntu 20.04 / Debian 11 | Windows 11, macOS 14, Ubuntu 22.04 |
| Node.js | 20.0+ | 20 LTS or 22 LTS |
| Git | 2.30+ | 2.40+ |
| RAM | 4 GB | 8 GB+ (Swarm QA with 5+ agents) |
| Disk | 500 MB cache + space for Playwright browsers (~600 MB) | 2 GB+ |
| CPU | Dual-core x64 / arm64 | Quad-core or better |
Verify your environment:
node --version # Should print v20.x or higher
git --version # Should print 2.30 or higherTIP
Apple Silicon and Linux ARM64 are supported natively. The agent ships a single npm package — no platform-specific binaries.
Playwright Browsers
The agent uses Playwright to drive Chromium, Firefox and WebKit. On first run it offers to install the binaries; you can also run the install manually:
# All browsers (~600 MB)
npx playwright install
# Only Chromium (~200 MB)
npx playwright install chromiumBrowser disk space breakdown
- Chromium: ~200 MB
- Firefox: ~250 MB
- WebKit: ~150 MB
Network Requirements
| Feature | Network access |
|---|---|
| Portal sign-in & dashboards | HTTPS to xyva.ai |
| Agent ↔ Portal bridge | Outbound WSS from your laptop to the portal (no inbound ports) |
| Test execution against your app | Whatever your tests target |
| AI features (Brain, Swarm) | Outbound HTTPS to your AI provider |
| CI/CD integration | GitHub / GitLab API access |
| Checkmk monitoring | Checkmk REST API |
WARNING
If your organization uses a corporate proxy, configure it under Portal → Settings → Proxy & Network and set HTTPS_PROXY for the agent process. See Proxy & Network.
Optional: WireGuard VPN
Private deployments can use WireGuard to reach self-hosted services (AI proxy, internal GitLab, monitoring). Install the WireGuard client separately:
- Windows: WireGuard for Windows
- macOS: App Store or Homebrew (
brew install wireguard-tools) - Linux:
sudo apt install wireguard