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.3.0

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.3.0
File Size Uploaded
marimo_studio-0.3.0.tar.gz 12.2 MB Details

Built distribution (wheel)

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

Total release size: 24.8 MB

Release files / marimo_studio-0.3.0.tar.gz

Download URL marimo_studio-0.3.0.tar.gz
Size 12.2 MB
Tags Source
SHA-256 checksum
How to use checksums
3ddb1573a3e7aeecd26350bf985a4099e6f92d57315672ad84a0c2d3007cf520
BLAKE2b-256 checksum
How to use checksums
5f1591826c91fa9af3446a7215787c78d51c0788959743bae63b5f77630e21b7
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.3.0-py3-none-any.whl

Download URL marimo_studio-0.3.0-py3-none-any.whl
Size 12.6 MB
Tags Python 3
SHA-256 checksum
How to use checksums
e472d589960b998112fb34bba8088f76da691f782e7414b4382b7ee268ba4ccb
BLAKE2b-256 checksum
How to use checksums
9afebd5252553117b52108ac6f0df8f01d8929813119abe6ce1bf116a33b0882
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

This release

0.3.0 This release

2 release files

0.2.3

2 release files

0.2.2

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