Examples

This page includes dozens of bite-sized how-to examples to help you get started with marimo. Be sure to also read the quickstart and the user guide, especially the guide on how marimo runs cells.

!!! Tip "Get inspired at our gallery!"

For inspirational examples, including embedding-driven
data labelers, Stanford-scientist authored tutorials, and more,
check out our [public gallery](https://marimo.io/gallery).

Running cells

⚡️ Basic execution
🐞 Getting around multiple definition errors
🛑 Stop cells from running
🖱️ Run cells on button click
🕓 Refresh on a timer
⏳ Run async functions
💾 Caching computations in memory
💾 Cache computations to persistent storage
🐞 Using the debugger
🐍 Run notebooks as scripts

</div>

Visual Outputs

📤 Cell outputs
✍️ Basic markdown
💬 Console outputs
📋 Capturing console output
📈 Showing plots
🎥 Showing videos and other media
🎛️ Conditionally showing outputs
🧩 Showing multiple outputs in one cell

</div>

Writing markdown

⚡️ Python values in markdown

<a href="markdown/dynamic_markdown"></a>
🪄 Mermaid diagrams

<a href="markdown/mermaid"></a>
🚨 Admonitions

<a href="markdown/admonitions"></a>
📂 Collapsible details

<a href="markdown/details"></a>
😀 Emoji

</div>

Working with data

Dataframes

marimo is designed for working with dataframes. Here are a few examples; see the dataframes guide for details.

🧮 Interactive dataframe viewer

<a href="outputs/dataframes"></a>
🔍 Select dataframe rows

<a href="../api/inputs/table"></a>
✏️ Editable dataframe

<a href="api/inputs/data_editor"></a>
🛠️ Interactive dataframe transformer

<a href="api/inputs/dataframe"></a>

</div>

SQL

Here are some basic examples, see the SQL guide for more details.

🦆 Query dataframes with DuckDB SQL
🛢️ SQLite, Postgres, and other engines

</div>

Plots

See the plotting guide for a full overview.

📊 Selecting data with Altair

<a href="../api/plotting#reactive-charts-with-altair"></a>
📉 Selecting data with Plotly

<a href="../guides/working_with_data/plotting#Plotly"></a>
🔭 Showing matplotlib plots

</div>

Progress bars and status elements

📶 Progress bar

<a href="outputs/progress_bar"></a>
🌀 Loading spinner

<a href="outputs/spinner"></a>

</div>

Layouts

📐 Horizontal and vertical stacking

<a href="outputs/stacks.md"></a>
📁 Accordion toggle

<a href="../api/layouts/accordion"></a>
🗂️ Tabs

<a href="../api/inputs/tabs"></a>

</div>

Input elements

Basic input elements

marimo has a large library of interactive UI elements, which you can use without callbacks — just make sure to assign elements to global variables. See the API reference for a full list, and the interactivity guide for rules governing how UI elements work.

🎚️ Slider

<a href="../api/inputs/slider.md"></a>
🧾 Dropdown

<a href="../api/inputs/dropdown.md"></a>
👆 Multi-select

<a href="../api/inputs/multiselect.md"></a>
🔘 Radio buttons

<a href="../api/inputs/radio.md"></a>
☑️ Checkbox

<a href="../api/inputs/checkbox.md"></a>
📅 Date

<a href="../api/inputs/date.md"></a>
📁 File

<a href="../api/inputs/file.md"></a>
🔤 Text input

<a href="../api/inputs/text.md"></a>
📝 Text area

<a href="../api/inputs/text_area.md"></a>
🧑‍💻 Code editor

<a href="../api/inputs/code_editor.md"></a>
🔍 Table

<a href="../api/inputs/table.md"></a>
🎙️ Microphone

<a href="../api/inputs/microphone.md"></a>
💬 Chat

<a href="../api/inputs/chat.md"></a>
🔢 Matrix

<a href="../api/inputs/matrix.md"></a>

</div>

Composite input elements

Composite input elements let you create a single UI element from multiple other UI elements.

🧾 Form

<a href="../api/inputs/form.md"></a>
🎒 Array

<a href="../api/inputs/array.md"></a>
📖 Dictionary

<a href="../api/inputs/dictionary.md"></a>

</div>