This folder contains example marimo notebooks, meant to teach you how to use marimo's features as well as inspire you to make awesome notebooks.
- 🖱️
ui/: how to use UI elements or widgets - 🛢️
sql/: how to use SQL in marimo - ⛲
control_flow/: how to control cell execution and output display - 📝
markdown/: how to write markdown, including dynamic markdown - 📽️
layouts/: how to present notebooks as slides, add sidebars, and more - 🤖
ai/: AI-related examples - 🧪
testing/: how to test marimo notebooks, and use marimo notebooks as tests - 📦
third_party/: using popular third-party packages in marimo - ☁️
cloud/: using various cloud providers - 🧩
frameworks/: integrating with different frameworks (web/ASGI) - ✨
misc/: miscellaneous topical examples
Tip
New to marimo? Run marimo tutorial intro at the command line first!
Tip
Check out our public gallery of interactive notebooks to get inspired.
Note
Submit a
pull request to add an example!
We especially welcome library developers to add examples to third_party/.
The requirements of each notebook are serialized in them as a top-level comment. Here are the steps to open an example notebook:
- Install
uv - Open an example with
marimo edit --sandbox <notebook-url>.
For example:
uvx marimo edit --sandbox https://github.com/marimo-team/marimo/blob/main/examples/misc/seam_carving.pyTip
The --sandbox flag opens the notebook in an isolated virtual environment,
automatically installing the notebook's dependencies 📦
You can also open notebooks without uv, in which case you'll need to
manually install marimo
first. Then run marimo edit <notebook.py>; however, you'll also need to
install the requirements yourself.
Every week, we highlight stellar examples and projects from our community. Check them out at our marimo spotlights repo!