Guides

These guides cover marimo’s core concepts.

Learn by doing!

Prefer a hands-on learning experience? marimo comes packaged with interactive tutorials that you can launch with marimo tutorial at the command line.

Guide

Description

Overview

An overview of basic concepts

Reactivity

How reactive execution works

Interactivity

Using interactive UI elements

Outputs

Creating markdown, plots, and other visual outputs

Working with data

Using SQL cells, no-code dataframe tools, and reactive plots

Editor features

View variables, dataframe schemas, docstrings, and more

Configuration

Configure various settings

Run as an app

Running notebooks as apps

Run as a script

Running notebooks as scripts

Best practices

Best practices to help you get the most out of marimo

Coming from other tools

Transitioning from Jupyter and other tools

Integrating with marimo

Rich displays of objects, custom UI plugins

Reactive state

Advanced: mutable reactive state

Online playground

Create notebooks in our online playground

Exporting

Exporting notebooks to HTML and flat scripts

Deploying

Deploying marimo notebooks and apps

Troubleshooting

Troubleshooting notebooks