Loading...
Loading...
Guide for creating and working with marimo notebooks, the reactive Python notebook that stores as pure .py files. This skill should be used when creating, editing, running, or deploying marimo notebooks.
npx skill4agent add maragudk/skills marimo.pypip install marimo # Basic
pip install marimo[recommended] # With extras
pip install marimo[sql] # With SQL support
marimo tutorial intro # Start tutorial# Edit
marimo edit # New notebook
marimo edit notebook.py # Edit existing
marimo edit --watch --sandbox # Watch files, isolate deps
# Run as app
marimo run notebook.py # Read-only app
marimo run notebook.py --watch # Auto-reload on changes
# Run as script
python notebook.py
# Create from prompt
marimo new "analyze sales data"
# Convert
marimo convert notebook.ipynb -o notebook.py
# Export
marimo export html notebook.py -o output.html
marimo export html-wasm notebook.py -o output.html # Browser-executablelist.append()import marimo
app = marimo.App()
@app.cell
def _():
import marimo as mo
return (mo,)
@app.cell
def _(mo):
mo.md("# My Notebook")
return ()references/| API | Reference File | Description |
|---|---|---|
| Markdown | | |
| HTML | | |
| Outputs | | |
| API | Reference File | Description |
|---|---|---|
| Inputs | | Sliders, text, dropdowns, tables, forms, etc. |
| Layouts | | |
| Media | | Images, audio, video, PDF, downloads |
| Plotting | | Altair, Plotly, matplotlib integration |
| Diagrams | | Mermaid diagrams |
| Status | | Progress bars, spinners |
| API | Reference File | Description |
|---|---|---|
| SQL | | |
| API | Reference File | Description |
|---|---|---|
| Control Flow | | |
| State | | |
| Caching | | |
| Query Params | | |
| CLI Args | | |
| Watch | | |
| App | | Embedding notebooks, |
| Cell | | Cross-notebook execution, testing |
import marimo as mo
slider = mo.ui.slider(0, 100, value=50, label="Threshold")
slider
# In another cell
mo.md(f"Selected value: **{slider.value}**")table = mo.ui.table(df, selection="multi")
table
# In another cell
selected = table.value # Selected rows as DataFrameresult = mo.sql(f"SELECT * FROM {df} WHERE value > {threshold.value}")mo.stop(form.value is None, mo.md("Submit the form to continue"))
# Rest of cell runs only after form submissionmarimo run notebook.py # Local app
marimo export html-wasm notebook.py # Static WASM app@mo.cachemo.stop()mo.state()