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

Reactive execution

How marimo runs cells

Interactive elements

Using interactive UI elements

Visualizing outputs

Creating markdown, plots, and other visual outputs

Expensive notebooks

Tips for working with expensive notebooks

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

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 to HTML and other formats

Exporting notebooks to HTML and flat scripts

Deploying

Deploying marimo notebooks and apps

Best practices

Best practices to help you get the most out of marimo

Troubleshooting

Troubleshooting notebooks