Overview

// OVERVIEW

What Vivarium is.

A platform for reproducing bugs across any language and any environment, from a single browser tab.

// 01 · WHAT IT GIVES YOU

A platform for bug reproduction.

Vivarium is a platform for reproducing bugs. Open a page, click once, and find out whether a previously-reported bug still reproduces — or whether a candidate fix actually fixes it.

For each upstream bug, the catalogue holds one recipe. Every recipe satisfies the same verdict.json v1 contract, so each page returns either reproduced (the bug reproduces) or unreproduced (it does not). Results show inline on the page and are also exposed as machine-readable JSON.

Vivarium ships bugs as runnable artefacts, not write-ups. Instead of someone telling you "this is a bug," you open it in your browser and watch.

The trigger was the surge of AI-generated bug reports and pull requests. Maintainers were drowning in plausible-but-unverified claims arriving at machine speed, and contributors had no way to check whether their own AI-drafted fixes actually worked. The shared root cause — no cheap, universal way to verify whether a bug is real or whether a fix actually fixes it — is what Vivarium addresses.

// 02 · THREE EXECUTION SURFACES

Each recipe declares the layer that fits the bug.

Bugs differ wildly in what environment they need. Vivarium organises reproduction techniques into three layers, and you don't pick the layer — the recipe declares it for you.

L1

Instant start, browser-native

The reproduction runs directly in your browser via WebAssembly. Startup is milliseconds to a few seconds. Right for algorithms, parsers, data processing, and in-memory database operations — bugs that don't need a full OS.

Pyodide · sqlite-wasm · wasm32-wasi · Ruby.wasm · PHP.wasm
L2

Full fidelity, container execution

The reproduction runs inside Docker or a microVM. Startup is seconds to a minute. Right for bugs that depend on a real filesystem, real processes, or real networking.

Docker · Firecracker · gVisor
L3

Third way

Record-replay, deterministic simulation, WASI Preview 3+, snapshot-based restore — and techniques that don't exist yet. For bugs that L1 and L2 can't reach.

rr · Antithesis · CRIU · WASI Preview 3+
See all three layers in action. The gallery shows L1 / L2 / L3 recipes side-by-side with facet filters, so you can compare layers in one click.Reproductions

// 03 · WHERE TO START

One first page per audience.

// NEXT

Try it yourself

The fastest way to understand Vivarium is to open one recipe in a browser tab and read the verdict.

VIVARIUM is part of ALETHEIA-WORKS · See the source on GitHub →