mowidgets 0.2.1

Reusable widgets for marimo notebooks

mowidgets

Reuse marimo notebooks as widgets inside other marimo notebooks! This allows to build libraries of reusable widgets and distribute them.

This uses native marimo features and the standard Python library; no extra dependencies.

Installation

pip install mowidgets

Tutorial

As an example, we create a simple widget that multiplies two numbers and displays the result.

1. Create a marimo notebook to define the widget.

   marimo edit multiply.py  # widget module name
   

2. Create a marimo notebook for the main app.

   marimo edit app.py
   

3. From the multiply (widget module name) Python module, import the app variable.

   from multiply import app as multiply_app
   

4. Use mowidgets.widgetize() on the marimo.App instance to create the widget.

   multiply_widget = mowidgets.widgetize(multiply_app)
   

5. Call await in front of the widget instance to render it.

   await multiply_widget
   

6. Using mowidgets.widgetize(..., data_access=True) allows to read values exposed by the widget. You even get autocompletion!

See the examples/ directory to see complete files.

Known limitations

• Using a setup cell cell in the primary notebook seems to create issues where the widget blocks the primary execution loop. Replacing the setup cell by regular cell avoids the problem.

Next steps

• Pass starting values to the MoWidget instance. This would allow to compose widgets together. (Idea well-received by the core dev team)
• Have MoWidget expose a reliable input and output schema. Optionally add type coercion via Pydantic.
• Simplify the import experience. Currently, the user must import the marimo.App instance in the main namespace for the widget to properly refresh.