Symphony

E2E testing made effortless for web

Symphony is tool to help you write E2E test like human, it use a YAML to define tests

▶ Watch the full 28-second demo

---

Why Symphony?

Symphony is built on a simple belief: end-to-end testing should feel like talking to a human, not programming a machine.

Today, front end E2E testing tools force users to think in code, frameworks, and technical abstractions. But real testing starts from a much simpler place, how a user behaves. A user doesn’t think in JavaScript, Playwright APIs, or Cypress commands. They think in actions:

“Open the app → log in → click buy → make sure it worked.”

Symphony believes that writing tests should be as easy as describing behavior in plain English.

We want E2E testing to:

• Be language-agnostic, not tied to JavaScript or any one tech stack
• Work for non-technical users, not just QA engineers
• Adapt naturally to real user flows, not brittle selectors
• Reduce cognitive load so teams focus on what to test, not how to write it

In an ideal world:

• A QA engineer, product manager, or frontend developer can write a test without learning a new framework
• A test reads like a conversation, not a script
• Tests are resilient, human-like, and easy to maintain
• Adoption doesn’t require weeks of learning or heavy setup

Symphony is designed to be that layer, a human-first interface for E2E testing, where intent matters more than syntax.

How to install

🧩 Prerequisites

Symphony requires Bun version 1.3.0 or higher.
If you don’t have Bun installed yet, follow the official installation guide — it only takes a minute.

💡 Tip: Run bun --version to check your current version.

---

⚙️ Installation

You can install Symphony in using bun or npm.

📦 NPM install

If you prefer installing through npm or are on Windows/Linux/MacOS, run the following command:

npm install -g @kriptonian/symphony

then run the following command to setup symphony

1. If you're on Linux or MacOS, run:

curl -sL https://raw.githubusercontent.com/kriptonian1/symphony/refs/heads/develop/scripts/setup.sh | bash

Warning

Playwright browser extension is broken for windows. We will fix this soon.

2. If you're on Windows, run:

iwr -useb https://raw.githubusercontent.com/kriptonian1/symphony/refs/heads/develop/scripts/setup.ps1 | iex

Tip

For Windows Users: If you encounter a permission error, run the following command first:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Then go to step 2 above to run the setup script.

Then check your installation:

symphony --version

📚 Documentation

• 🚀 Getting Started
  Learn how to install Symphony, write your first YAML test, and run it locally.
• 🧠 YAML DSL Reference
  A complete reference of Symphony’s human-readable testing language — steps, syntax, and execution rules.