Skip to content

Latest commit

聽

History

206 Commits

Folders and files

NameName
Last commit message
Last commit date
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽
聽

marimo-studio

Four example notebooks, each heading a column of its views

One reactive notebook. Many views.
Turn a marimo notebook into reports, apps, and presentations, by hand or with a coding agent.

CI PyPI Python 3.10 through 3.14

Studio keeps data, computation, and controls in the notebook and gives each audience its own view, such as a report, a dashboard, a lab, or a slide deck. Views render the notebook's live cells and controls, so changing an input updates the results that depend on it. Each view is its own frontend project, and every result it shows traces back to the notebook cell that computed it.

Note

Studio is experimental and changing rapidly. Pin marimo-studio in saved projects.

Start with a coding agent

Paste this request into Claude Code, Codex, or another terminal agent:

Run `uvx --with marimo-studio agent-plugins read marimo-studio` and create
a scrollytelling report and a slide deck explaining calculus basics.

The agent reads the instructions Studio ships for coding agents, starts a notebook with Studio in your browser, and writes the calculus in Python cells. It then builds both views and shows them beside the notebook. Change the topic, or name a notebook you already have. uv supplies uvx.

Author with a coding agent covers pairing with a running notebook and pointing at results with Lens.

Start by hand

uvx --with marimo-studio marimo edit analysis.py --sandbox --watch

Add a cell that displays a result, then click Add view in the Studio toolbar. Save the notebook if prompted, choose HTML document, and create the view. Notebook and Preview open side by side. Saving view source rebuilds Preview, and a failed build keeps the last successful view.

Notebook, Preview, and view source in Studio

Getting started walks through a complete first view.

Examples

Each example notebook serves three views, built with different frontend stacks.

Notebook Views Built with
Quadratic programs Lecture 路 Explainer 路 Lab React, Reveal.js, HTML, Svelte, D3
Rio 2016 athletes Overview 路 Explorer 路 Field HTML, Svelte, Mosaic, Shower, Three.js
Earthquake watch Story 路 Operations 路 Briefing HTML, Observable Plot, React, MapLibre, Reveal.js, D3
Building occupancy Monitor 路 Model review 路 PDF report Notebook Kit, Observable Plot, React, Recharts, React PDF

Run or export a view

Serve the notebook's views as a live Python app:

uvx --with marimo-studio marimo run analysis.py --sandbox

Export the report view with Prepared results as a static site:

uvx marimo-studio view export report --target analysis.py --output dist/report

A Prepared export publishes the exported results and finite input states and keeps notebook source on the machine that runs the export. Views can also run Python in the visitor's Browser. Run or export a view compares what visitors receive.

Documentation

Guide 路 Examples 路 Reference 路 Troubleshooting 路 Security 路 Contributing

License

Apache License 2.0.

Releases

Packages

Contributors

Languages