marimo-guide

Create interactive reactive Python notebooks and UI widgets with marimo.

Updated Jan 17, 2026
One-click install
npx skills add https://github.com/inakam/dotfiles-raspberry --skill marimo-guide
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: marimo-guide
Source: https://github.com/inakam/dotfiles-raspberry/tree/main/dot_claude/skills/marimo-guide
Command: npx skills add https://github.com/inakam/dotfiles-raspberry --skill marimo-guide

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

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.

Frequently Asked Questions about marimo-guide

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a reactive Python notebook with marimo?

Create a reactive Python notebook by defining an App object, adding @app.cell functions that return marimo UI widgets, and running it as a web app with marimo run. This cell-based model automatically manages reactive execution dependencies.

Can I use SQL queries inside a marimo notebook?

Yes, you can write SQL cells directly in a marimo notebook to query connected databases. The SQL query results integrate seamlessly into interactive dashboards and can be filtered using marimo UI widgets.

What is the best way to convert a Jupyter notebook into a deployable web app?

Converting a Jupyter notebook into a deployable web app involves defining an App object with @app.cell functions and running it with marimo run. You can also deploy the resulting application using Docker.

How does marimo handle reactive execution to avoid circular dependencies?

Marimo uses a cell-based reactive execution model that automatically tracks dependencies between cells. Following best practices for cell design helps avoid common pitfalls like mutation and circular dependencies during notebook authoring.

Does marimo support UI components for building interactive data dashboards?

Yes, marimo provides mo.ui widgets and layout primitives for building interactive data dashboards. You can implement forms, tables, and visualizations, then use UI controls to filter datasets and visualize results with Plotly.

What are the deployment options for a marimo notebook?

Marimo notebooks can be deployed as web apps using Docker containers. The framework provides deployment guidance including authentication options, debugging strategies, and caching mechanisms for production environments.