# Marimo Studio

> Web views for reactive Python notebooks

Turn reactive Python into reports, apps, and presentations. Work with a coding agent, and keep every view connected to your analysis.

## Table of Contents

### Introduction

- [What is Studio?](https://marimo-team.github.io/marimo-studio/what-is-studio.md): Keep one reactive analysis behind web views built for different audiences and tasks.

### Start

- [Guide](https://marimo-team.github.io/marimo-studio/guide.md): Create a view, refine its presentation, and deliver it to your audience.
- [Create your first view](https://marimo-team.github.io/marimo-studio/guide/getting-started.md): Open a saved Marimo notebook, create a view, and place one reactive result inside it.
- [Author with a coding agent](https://marimo-team.github.io/marimo-studio/guide/coding-agents.md): Give an agent Studio's installed instructions, ask for a view, and review its rendered result.
- [Create and manage views](https://marimo-team.github.io/marimo-studio/guide/views.md): Create, switch, and remove the named views of a notebook.
- [Place notebook results in a view](https://marimo-team.github.io/marimo-studio/guide/notebook-results.md): Use complete cells, rendered outputs, and browser values in view source documents.

### Author

- [Edit and preview in Studio](https://marimo-team.github.io/marimo-studio/guide/work-in-studio.md): Work with notebook code, view source, and the rendered result in one Marimo session.
- [Manage view source](https://marimo-team.github.io/marimo-studio/guide/manage-source.md): Understand the Source catalog, view manifest, build inputs, conflicts, and recovery files.
- [Style a view](https://marimo-team.github.io/marimo-studio/guide/styling.md): Use authored CSS, theme tokens, and projection variables in a Studio view.
- [Choose a frontend](https://marimo-team.github.io/marimo-studio/guide/frontend-options.md): Match each view to the smallest frontend and browser toolchain that supports its task.

### Deliver

- [Navigate and preserve state](https://marimo-team.github.io/marimo-studio/guide/navigation-and-sessions.md): Link named views, synchronize public query parameters, use fragments, and control Python session replay.
- [Run or export a view](https://marimo-team.github.io/marimo-studio/guide/run-and-share.md): Run a view with Python or WebAssembly, or export prepared results as a static directory.
- [Deploy a live Python view](https://marimo-team.github.io/marimo-studio/guide/deploy.md): Serve a Studio view with authentication, a managed process, a reverse proxy, and health checks.
- [Troubleshoot Studio](https://marimo-team.github.io/marimo-studio/guide/troubleshooting.md): Diagnose view discovery, provider, source, build, projection, runtime, and browser failures.

### Examples

- [Examples](https://marimo-team.github.io/marimo-studio/examples.md): Compare twelve live views backed by four Marimo notebooks.
- [Quadratic programs](https://marimo-team.github.io/marimo-studio/examples/quadratic-programs.md): Compare a lecture deck, a reading explainer, and an interactive geometry lab backed by one quadratic program notebook.
- [Rio 2016 athletes](https://marimo-team.github.io/marimo-studio/examples/athletes.md): Compare an overview report, a Mosaic explorer, and a Three.js field presentation backed by one Rio 2016 athlete notebook.
- [Earthquake watch](https://marimo-team.github.io/marimo-studio/examples/earthquakes.md): Compare a scrolling story, an operations map, and a briefing deck backed by one weekly earthquake notebook.
- [Building occupancy](https://marimo-team.github.io/marimo-studio/examples/occupancy.md): Compare a room monitor, a model review, and a printable PDF report backed by one room-sensor notebook.

### Reference

- [Reference](https://marimo-team.github.io/marimo-studio/reference.md): Exact commands, configuration, projection, Python, provider, compatibility, limit, identity, and error contracts.
- [CLI](https://marimo-team.github.io/marimo-studio/reference/cli.md): Inspect notebooks and create, edit, build, show, preflight, validate, export, and remove Studio views.
- [Python API](https://marimo-team.github.io/marimo-studio/reference/python-api.md): Inspect notebooks, author views, verify the current Studio tab, and serve a configured notebook.
- [Configuration](https://marimo-team.github.io/marimo-studio/reference/configuration.md): Configure server entry, embedding, the notebook, default view, runtimes, aliases, view projects, provider options, and saved files.
- [Notebook result projections](https://marimo-team.github.io/marimo-studio/reference/projections.md): Exact cell, output, value, selector, event, state, duplication, and data contracts for rendered views.
- [Built-in view providers](https://marimo-team.github.io/marimo-studio/reference/built-in-providers.md): Provider keys, starter IDs, source documents, requirements, and view.toml options included with Marimo Studio.
- [Compatibility and support](https://marimo-team.github.io/marimo-studio/reference/compatibility.md): Supported Python, Marimo, Deno, uv, browser, runtime, release, provider, deployment, and security contracts for Marimo Studio 0.2.
- [View provider API](https://marimo-team.github.io/marimo-studio/reference/provider-api.md): Register a view provider that creates, inspects, and builds frontend view projects.
- [Identities and state](https://marimo-team.github.io/marimo-studio/reference/identities.md): Canonical product terms, stable names, revisions, generations, runtime identities, and state mappings.
- [Limits](https://marimo-team.github.io/marimo-studio/reference/limits.md): File, source, provider, projection, payload, output, and timeout limits enforced by Marimo Studio.
- [Errors and JSON](https://marimo-team.github.io/marimo-studio/reference/errors-and-json.md): Stable JSON result, JSON Lines progress and diagnostics, HTTP error, Python exception, and exit-status contracts.

### Other

- [Marimo Studio](https://marimo-team.github.io/marimo-studio/index.md): Turn reactive Python into reports, apps, and presentations with a coding agent.