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

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.3
File Size Uploaded
marimo_studio-0.2.3.tar.gz 12.3 MB Details

Built distribution (wheel)

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

Total release size: 25.0 MB

Release files / marimo_studio-0.2.3.tar.gz

Download URL marimo_studio-0.2.3.tar.gz
Size 12.3 MB
Tags Source
SHA-256 checksum
How to use checksums
dd2cbdad75f20ed51725e24e8915ebf1efafb91a225e7bffaceae8855640e8d2
BLAKE2b-256 checksum
How to use checksums
9dd34c4393b5d13022e12d2041b3f0a7460944d5f52218eb1c1ca89f6f666a2e
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.3-py3-none-any.whl

Download URL marimo_studio-0.2.3-py3-none-any.whl
Size 12.7 MB
Tags Python 3
SHA-256 checksum
How to use checksums
7928ecef5044c6dace9306db0ae04619ce3cc9f5d1b685e667b4bc57d2e516be
BLAKE2b-256 checksum
How to use checksums
143519341474b7694d7bc8932612b33c842bbbe4257ebc45ec5f9f123fee3f9f
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

This release

0.2.3 This release

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