marimo-guide

What problem does it solve?

Enables developers to build and maintain interactive, reactive Python notebooks using the marimo framework, reducing friction when creating UI-driven data tools and dashboards.

Core Features & Use Cases

• Reactive notebook guidance: explains marimo's cell-based reactive execution model and best practices to avoid common pitfalls like mutation and circular dependencies.
• UI components & layouts: documents available mo.ui widgets, layout primitives, and patterns for forms, tables, and visualizations.
• Data and SQL integration: shows how to connect databases, write SQL cells, and integrate query results into interactive dashboards.
• Deployment & debugging: includes instructions for running as a web app, Docker deployment, authentication options, and debugging/caching strategies.
• Use Case: build an interactive data-exploration dashboard that filters a dataset with UI controls, runs SQL-backed queries, and visualizes results with Plotly.

Quick Start

Use marimo to create a new notebook by defining an App, adding @app.cell functions that return mo and mo.ui widgets, and run it as a web app with marimo run notebook.py.