If you’ve ever written an end-to-end test, you know the feeling. The flow works perfectly by hand, but the moment you try to automate it you’re three layers deep in CSS selectors, XPath, and explicit waits — and a week later a designer renames a class and the whole suite goes red. QA engineers and SDETs spend an enormous share of their lives not testing software, but babysitting brittle locators and chasing flaky failures that have nothing to do with the product.
Modern AI changed what’s possible. An agent can now look at a page the way a person does, reason about it, and drive the browser straight from a sentence like “log in, add the blue running shoes to the cart, and check the total is correct.” No selectors to maintain. When the page changes, the agent adapts the way a human tester would. That capability shouldn’t be a luxury — and it absolutely shouldn’t be locked behind API keys, credit cards, and per-token bills that scare teams away before they’ve run a single test. So we built BrowserBash to be free and open, and to run with zero keys out of the box.
Who’s behind it
BrowserBash is made by The Testing Academy — a QA and test-automation education community founded by Pramod Dutta. For years The Testing Academy has taught testers how to automate the right way: Selenium, Playwright, API testing, CI pipelines, the whole craft. BrowserBash grew directly out of that teaching. We kept watching capable testers lose days to selector churn and environment setup, and we wanted to put something genuinely better in their hands. So we built BrowserBash for the exact people we teach — and released it as free, open-source software under the Apache-2.0 license so anyone can read it, trust it, and build on it.
What makes it different
- Free forever, open source. The CLI is Apache-2.0 licensed. Install it with
npm install -g browserbash-cliand you’re running — no trial, no paywall on the core tool. - No keys, no credit card.BrowserBash runs on free local models through Ollama, or free models via OpenRouter — with zero API keys required. Already have an Anthropic or OpenRouter key? Bring it. You’re never forced to.
- Built by testers, for testers. Plain-English objectives, Markdown
*_test.mdtest files with@importcomposition, variable templating with secret masking, an NDJSON agent mode, and clean CI exit codes — the things real test suites actually need. - Works with the tools you already use. Drive a real local Chrome, any CDP endpoint, or cloud grids like LambdaTest, BrowserStack, and Browserbase. Record runs with
--record, and review them in a free local dashboard or an optional cloud one.
Our principles
A few beliefs shape every decision we make:
- Local-first and private. By default the CLI runs entirely on your machine. Your objectives, the pages it visits, your recordings, and your credentials stay with you. Nothing reaches our servers unless you choose to sign in and upload a run.
- Free and open.The tool that does the work is open source and costs nothing. We don’t sell your data and we don’t train models on your runs. If we ever charge, it’s for an optional convenience like longer cloud retention — never for the ability to test your own software.
- Meet testers where they are. No new ecosystem to adopt. BrowserBash plugs into the browsers, grids, and CI pipelines teams already run, so adopting it is a small step, not a migration.
We’re building BrowserBash in the open and shipping fast — the CLI is currently at v1.3.1. If it saves you from one more afternoon lost to a flaky locator, it’s doing its job. Got feedback, found a bug, or want to contribute? Reach us anytime at thetestingacademy@gmail.com.