suiflex/suitest

View on GitHub ↗

Self-hostable, MCP-native testing platform. Manual test management, deterministic runs, optional AI. Your stack, your LLM, your data.

23 ★4 forksPythonUpdated 18d ago

What you need to know

Self-hostable, open-source QA platform that is MCP-native: manual test case management plus a deterministic run engine that drives any target through MCP (Playwright, HTTP APIs, Postgres), fully usable without an LLM (ZERO tier) and with optional BYO-LLM AI features.

Install

npx @suiflex/suitest onboard
npx -y @suiflex/suitest-mcp
brew install suiflex/tap/suitest && suitest onboard

Usage

  • The bundled MCP server gives IDE agents 22 tools: analyze a repo, generate runnable tests, execute them with video/screenshot evidence, and publish results.
  • Blackbox DOM engine tests any web app from just a URL + test credentials — no repo access and no LLM key needed.
  • Write a test case whose steps target an MCP provider (e.g. bundled playwright-mcp) with JSON tool calls, run it, and triage rule-based auto-filed defects.
  • Enable AI per-workspace in Settings → LLM (Anthropic/OpenAI/Gemini/Ollama/any OpenAI-compatible URL) to unlock agent chat, PRD-driven generation and LLM codegen; default is ZERO (no LLM calls ever).

Key features

  • Manual TCM, deterministic runner via MCP (playwright, api-http, postgres providers), live WebSocket logs, screenshots + per-test video, MinIO artifacts.
  • Traceability matrix, rule-based defects, analytics, CI webhooks (GitHub/GitLab/Jira/Slack), UAT sign-off PDF export.
  • Deterministic generators (OpenAPI, browser recorder, crawler) and desktop targets (slint-mcp bundled in-process, electron-mcp and computer-use-mcp pinned binaries).
  • Deploys as one-command local bundle, Docker Compose, or Kubernetes Helm chart (incl. air-gapped LOCAL tier with in-cluster Ollama).
  • Two independently versioned packages: @suiflex/suitest (launcher/platform) and @suiflex/suitest-mcp (IDE tools).

Best for

QA teams wanting an open, self-hosted alternative to TestRail/TestSprite with manual TCM plus AI test generation and diagnosis wired through MCP.

Caveats

  • Pre-v1.0, under active development; docs/ROADMAP.md is the single source of truth for build status.
  • Local bundle needs Node >= 18 and uv; full Docker path needs Postgres/Redis/MinIO.
  • Local onboard mode uses SQLite on 127.0.0.1; LLM keys are AES-GCM encrypted at rest.
  • Apache-2.0 licensed.
Platforms: Local · Remote · WebClients: Claude Code · Cursor · Codex

Reviewed 2026-08-18

Topics

aiai-agentse2e-testingmcpmodel-context-protocolopen-sourceplaywrightqaself-hostedtest-automationtest-managementtesting
Stars
23★
Forks
4
Language
Python
License
Apache-2.0
Created
2026-05-22
Last push
2026-08-17