Opening workspace…
Read-only snapshot — run the workbench locally for the full interactive version. Read-only snapshot Get vivarium-workbench on GitHub →

Vivarium Workbench

A local, git-backed workspace for building, running, and sharing multi-scale simulations of cells and other living systems.

What is Vivarium?

Vivarium is a framework for integrative, multi-scale modeling. Instead of one monolithic model, you write small, self-contained Processes — each describing one mechanism (metabolism, gene expression, physics, transport) — and wire them together into Composites that share state through a typed bigraph. Processes advance in time (Temporal) or transform state as dataflow (Steps), and any composite can itself be used as a process inside a larger one. This makes models modular, reusable, and composable across scales — from molecules to whole cells to colonies.

Built on process-bigraph and bigraph-schema.

What is the Workbench?

The Workbench is a web UI over a Vivarium workspace — a directory of composites, studies, investigations, and data. It reads and writes that workspace, committing every action to a git branch so you get a full audit trail. From here you can browse the registry, configure and run simulations, explore a composite's wiring, organize work into studies and investigations, and view the resulting reports and visualizations.

Finding your way around

The left rail is a compact icon bar — hover any icon to see its name. It has three parts:

  • Workspace badge (top) — the avatar for the workspace you're in; click it to switch workspaces or open its Source (repository · branch · commit).
  • Pages — Investigations (the default view), Resources (datasets, references, and expert notes, plus the curated scientific resources a workspace ships), Catalog and Registry (the Composites and Processes you can configure, explore, and run), Runs (every simulation you've launched, with its results and artifacts), and Explore (interactive analysis & visualization matched to what your runs produced).
  • Panels (grouped at the bottom) — Studies, Chat, and Code open as inset windows you can dock to any edge and resize, so a study list, the AI assistant, or a process's source can sit beside your work.

Tip: open Catalog → Composites, pick a composite (e.g. ecoli_baseline), set Steps, and hit ▶ Run — progress and figures appear under Outputs. Press ⌘K to search everything.

Learn more

New to Vivarium, or want the full walkthrough? The user's guide covers getting started, building and composing models, running studies, and working with the AI agents — with a reference for the skills, HTTP API, and schemas.

Loading audit…

Loading resources…
Source

Loading…

Pick a composite or process

Open the Registry panel in the left rail and click any item to see its full card here.

Sort
Loading…
Loading…
Loading…
How this page works

This page controls where this workspace runs and how your work syncs with GitHub — two separate jobs, one per card below.

Source — where this workspace runs

  • Local is a workspace checked out on this machine; Cloud is a build registered on the GovCloud sms-api server.
  • Pick a Repo / Branch / Commit (or build), then Open ↗ to open it in a new tab (instant, non-destructive), or Use this environment to re-point this tab to it — that downloads the cloud environment's workspace the first time (a minute or two; cached builds are instant). You don't need to use the cloud environment to view results.
  • Build via sms-api registers a branch's current HEAD as a new cloud environment. Run locally gives you a command to recreate this exact source on your own machine.
  • In the build list, chips flag which build is in workspace ✓, on your workspace commit, or the latest.

GitHub — sync & collaborate

  • Account — the GitHub identity used to push (your gh session, or a pasted token).
  • Branch & sync — the workspace's git state: the branch vs its base, uncommitted Changes + push state, and any open pull request.
  • Commit + Push commits every change on the branch and pushes it; Open PR starts a pull request from it.

GitHub

Sync this workspace with GitHub — sign in, commit & push, open a PR.

Account

Signed in as
Uses your gh session, or paste a token for browser-based push.

Branch & sync

Branch
loading…
Changes
—
Pull request
—

Actions

Sync

Studies

Browse every study in the workspace — filter, sort, and open any of them (each belongs to an investigation).

Loading studies…

Loading simulations…
Loading composite…