Guides

These guides cover marimo’s core concepts.

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.

Coming from Jupyter

marimo for Jupyter users

Runtime configuration

Configure how and when cells are run

Outputs

Markdown, plots, and other visual outputs

Editor features

View variables, cell dependencies, errors, and more

Hotkeys

Keyboard shortcuts

Dataframes

Working with dataframes

Plotting

Interactive and reactive plots

Reactive state

Mutable, reactive state

Integrating with marimo

Rich displays of objects, custom UI plugins

Run as an app

Running notebooks as apps

Run as a script

Running notebooks as scripts

Best practices

Best practices when working with marimo

Performance

Writing performant notebooks

WASM notebooks

Running notebooks in the browser (no backend required!)

AI completion

Using AI to speed up your coding

Exporting

Exporting notebooks to HTML and flat scripts

Authentication

Authentication and security

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.