Suitest — A Testing Platform That Works for Everyone
Suitest Cloud collaboration is Coming Soon. The current product is the free, self-hosted platform. Every supported model provider unlocks the same features.
Усильте агента
Установка от издателя. Не эндпоинт PlugMCP.
Host a copy with our keys and logs.
В реестре пока нет пакетного релиза. Следуйте README репозитория.
Удалённый URL или команда на вашем компьютере? Чем различаются два способа установки
Запустить на PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
ЗапускОт издателя
Suitest Cloud collaboration is Coming Soon. The current product is the free, self-hosted platform. Every supported model provider unlocks the same features.
Self-hostable, MCP-native testing platform. Manual test management, deterministic runs, optional AI. Your stack, your LLM, your data.
Suitest is a free, self-hostable software testing platform.
Here's what that means: You have a website or app. You want to make sure all its features work correctly — buttons are clickable, forms can be filled, data is saved properly. In the old days, you'd use spreadsheets to track test cases and run each one manually. Suitest replaces all of that with a single application.
TestRail is paid ($30/user/month) and has no automated runner. Suitest combines TCM, an automated runner, and MCP plugins in one free self-hosted platform.
Playwright can only test browsers. Suitest uses Playwright as one of many plugins + adds TCM layer + traceability + multi-target (not just browsers).
TestSprite has vendor lock-in (their LLM, their cloud). Suitest: BYO LLM, self-host, universal MCP plugin (test API/DB/Infra/Mobile, not just browsers).
What you need:
Check if you have them installed:
Open a terminal (Command Prompt / PowerShell / Terminal) and type:
node --version # must be v18 or higher
uv --version # must be installed
Install Suitest:
npx @suiflex/suitest onboard
💡 What is
npx? It's part of Node.js that lets you run programs without manual installation.npx @suiflex/suitest onboarddownloads and runs Suitest automatically.
After installation, Suitest will give you a web address (usually http://localhost:4000). Open it in your browser.
First-time login:
💡 Tip: If you forgot your password, run
suitest settingsin the terminal to regenerate your API key.
💡 First time? Check out the interactive demo after running
make demo— it comes with pre-built test cases ready to go.
npx @suiflex/suitest onboard
What this command does:
Downloads and installs all required components.
Managing Suitest after installation:
If you only need the MCP server for IDEs (Claude Code, Cursor, Codex):
npx -y @suiflex/suitest-mcp
💡 What is MCP? MCP (Model Context Protocol) is a standard that lets AI agents (like Claude Code) run tests. With the MCP server, you can generate tests from your code repo.
Example configuration for Claude Code / Cursor (.mcp.json):
{
"mcpServers": {
"suitest": {
"command": "npx",
"args": ["-y", "@suiflex/suitest-mcp"],
"env": {
"SUITEST_API_URL": "http://localhost:4000",
"SUITEST_API_KEY": "sk_suitest_..."
}
}
}
}
💡
SUITEST_API_URLandSUITEST_API_KEYare required. MCP startup verifies the key and stops until the workspace LLM has been validated in Settings. Provider credentials stay on the Suitest server.
If you want to run all components (API, web, runner, database, Redis, MinIO):
git clone https://github.com/suiflex/suitest && cd suitest
cp .env.example .env
Edit .env — set a super-admin:
SUITEST_AUTH_SECRET=<32-char-random-hex> # generate: openssl rand -hex 32
[email protected]
SUITEST_SUPERADMIN_PASSWORD=<strong-password>
Run it:
make docker-up # pull images and boot the stack
open http://localhost:3000
💡 What is Docker Compose? Docker runs apps in "containers" (isolated environments). Docker Compose makes it easy to run multiple containers together. If you don't have Docker, install it from docker.com.
For deploying to a Kubernetes cluster:
helm install suitest infra/helm/suitest -f infra/helm/suitest/values.yaml
💡 Requires: Kubernetes cluster + Helm + PostgreSQL/Redis/object storage as external services.
If you want to contribute to Suitest:
# Requires: Python 3.12 + uv, Node 20 + pnpm, PostgreSQL/Redis/MinIO
make setup # copy .env → install deps → run migrations → seed DB
make dev # start API (:4000) + web (:3000) + runner together
Other useful commands:
Suitest is one free, self-hosted product. Login, workspace management, LLM Settings, and manual Test Case Management work before an LLM is connected.
MCP execution, test runs, and AI features start after an administrator saves and validates a workspace LLM in Settings → LLM. Ollama, llama.cpp, vLLM, LM Studio, Anthropic, OpenAI, Gemini, Groq, OpenRouter, and custom OpenAI-compatible endpoints all unlock the same product features.
Suitest Cloud is the future Suitest-hosted collaboration service. It is Coming Soon and is separate from the model provider you connect.
From a fresh install, you can bootstrap and run a real browser test:
playwright-mcp.💡 This entire journey is tested with a real Playwright suite —
make e2e-real
LLMs are configured per workspace from the web UI — Settings → LLM — not via env files.
How to activate:
Supported providers:
No LLM call is made until a workspace explicitly configures a provider.
suitest/
├── README.md ← you are here
├── CLAUDE.md ← coding rules for AI agents
├── Makefile ← all dev commands (make help)
│
├── apps/
│ ├── web/ ← Frontend (Vite + React 19)
│ ├── api/ ← Backend (FastAPI Python)
│ └── runner/ ← Worker that runs tests via MCP
│
├── packages/
│ ├── agent/ ← AI agent (LiteLLM + LangGraph)
│ ├── db/ ← Database (SQLAlchemy + Alembic)
│ ├── mcp/ ← MCP client + registry + bundled providers
│ ├── lifecycle/ ← MCP server: analyze→generate→run→publish
│ ├── mcp-npx/ ← @suiflex/suitest-mcp (npm launcher)
│ ├── suitest-npx/ ← @suiflex/suitest (one-command launcher)
│ ├── shared/ ← Shared Pydantic schemas
│ └── core/ ← Capability resolver, autonomy, crypto
│
├── sdk/
│ ├── python/ ← Python SDK (REST client)
│ └── typescript/ ← TypeScript SDK
│
├── infra/
│ ├── docker/ ← Dockerfile per service
│ └── helm/suitest/ ← Helm chart
│
└── docs/ ← Full documentation
Start at docs/ROADMAP.md — the single entry point for all features.
Yes. Suitest is open-source (Apache 2.0 License). No subscription fees. You can self-host without limits.
No. Create and manage test cases from the web dashboard. Executing them requires a validated workspace LLM and MCP provider.
For manual TCM, no. MCP execution, test runs, and AI features require a validated workspace LLM.
See Get Started in 3 Steps above. Just one command: npx @suiflex/suitest onboard
Yes. Suitest is self-hosted — your data never leaves your server. API keys are encrypted with AES-GCM. No mandatory telemetry.
Yes. Suitest can test: browsers (Playwright), APIs (HTTP/GraphQL/gRPC), databases (Postgres/Mongo/MySQL), mobile (Appium), desktop (Slint, Tauri), infrastructure (Kubernetes), and other MCP servers.
Check docs/TROUBLESHOOTING.md or open an issue at GitHub Issues.
Read CONTRIBUTING.md. In short:
feat/<scope>-<short-desc>feat(api): ...)make ci passes before pushingYes. Run make demo → open http://localhost:3000 → login [email protected] / demo1234
Use the --port flag: npx @suiflex/suitest onboard --port 5000
Yes. Suitest supports Windows, macOS, and Linux. Make sure Node.js ≥ 18 and uv are installed.
The whole workspace shares one version and ships on one vX.Y.Z tag. The two
packages you install directly:
Release notes: suitest.suiflex.dev/docs/changelog
feat/<scope>-<short-desc>. Commits: conventional commits (feat(api): ...)make ci must pass (ruff + mypy strict, tsc strict + ESLint, pytest async + vitest)See also CONTRIBUTING.md, CODE_OF_CONDUCT.md, and SECURITY.md.
Apache License 2.0. See LICENSE.
Built on Model Context Protocol (Anthropic), LiteLLM (BerriAI), LangGraph (LangChain), @ai-sdk/react + assistant-ui (Vercel), shadcn/ui, TanStack, and the FastAPI / SQLAlchemy / Pydantic ecosystems.
Self-hostable, MCP-native testing platform. Manual test management, deterministic runs, optional AI. Your stack, your LLM, your data.
Инструменты
Списка инструментов пока нет. У удалённых серверов он появляется после первой проверки состояния.
FAQ
Скопируйте на этой странице конфигурацию stdio для Cursor, Claude Desktop, Claude Code или VS Code. Она использует установку издателя, а не прокси PlugMCP.
В этой записи не указано обязательных переменных окружения.
Suitest работает локально через stdio.
Последняя проверка: 2026-10-28. Self-hostable, MCP-native testing platform. Manual test management, deterministic runs, optional AI. Your stack, your LLM, your data.