Skip to main content

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.

Studio is experimental and changing rapidly. Pin marimo-studio and third-party view providers 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 · Compatibility · Troubleshooting

Report bugs through GitHub Issues. See the security policy for private reports.

License

Apache License 2.0.

Metadata

Release files for marimo-studio 0.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for marimo-studio 0.2.2
File Size Uploaded
marimo_studio-0.2.2.tar.gz 12.3 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for marimo-studio 0.2.2
File Interpreter ABI Platform
marimo_studio-0.2.2-py3-none-any.whl Python 3 none any Details

Total release size: 25.0 MB

Release files / marimo_studio-0.2.2.tar.gz

Download URL marimo_studio-0.2.2.tar.gz
Size 12.3 MB
Tags Source
SHA-256 checksum
How to use checksums
65fc8e776e956841943ca5600a83b463045eaa26ee46af957a16e2fe579035a7
BLAKE2b-256 checksum
How to use checksums
d44a3ccf5325e029d0177aef77890559d7fdeb5f4aa56e62fa44eeac69433bb4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.12.7 {"installer":{"name":"uv","version":"0.12.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / marimo_studio-0.2.2-py3-none-any.whl

Download URL marimo_studio-0.2.2-py3-none-any.whl
Size 12.7 MB
Tags Python 3
SHA-256 checksum
How to use checksums
6f982086cb7b7cdf5b430201fa4a3b9c16dcf88b11632c4588a0ab44a0df98fd
BLAKE2b-256 checksum
How to use checksums
b44220c1d20b6179873c87ba501f43748777b39f917f35776a39603a01b6491d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.12.7 {"installer":{"name":"uv","version":"0.12.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release history Release notifications | RSS feed

0.3.0

2 release files

0.2.3

2 release files

This release

0.2.2 This release

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.0.6

2 release files

0.0.5

2 release files

0.0.4

2 release files

0.0.3

2 release files

0.0.2

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page