Guides

These guides cover marimo’s core concepts.

Guide

Description

Overview

An overview of basic concepts

Reactivity

How reactive execution works

Interactivity

Using interactive UI elements

SQL

Use SQL to query dataframes, databases, CSVs, etc.

Run as an app

Running notebooks as apps

Run as a script

Running notebooks as scripts

Outputs

Markdown, plots, and other visual outputs

Dataframes

Working with dataframes

Plotting

Interactive and reactive plots

Editor features

View variables, cell dependencies, errors, and more

Theming

Theming notebooks

Best practices

Notebook best practices

Coming from Jupyter

marimo for Jupyter users

Coming from other tools

Transitioning from other tools

Integrating with marimo

Rich displays of objects, custom UI plugins

Reactive state

Mutable, reactive state

Online playground

Create notebooks in our online playground!

Exporting

Exporting notebooks to HTML and flat scripts

Configuration

User and app configuration

Deploying

Deploying marimo notebooks and apps

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.