Marimo

What's Changed

Highlights

🐍 **`marimo export script`**: Export marimo notebooks as flat Python scripts:

`marimo export script notebook.py -o flat_script.py`

marimo notebooks are already executable as scripts (`python notebook.py`), but we're providing this for convenience, in case you need to use your notebook as a script in an environment that doesn't have `marimo` installed.

🔔 **Better UX for undoing cell deletion.** Many of you told us you didn't know how to undo cell deletions.

⌨ **Tab to start completions.** In addition to `Ctrl+Space`.

🏁 **Windows compatibility.** Fixes for our Windows users. Thanks for your patience!

Full changelog

* faq about late binding closures in Python by akshayka in https://github.com/marimo-team/marimo/pull/1204
* feat: `marimo export script`, to export notebook as a flat script by mscolnick in https://github.com/marimo-team/marimo/pull/1199
* Update readme intro by akshayka in https://github.com/marimo-team/marimo/pull/1206
* improvement: add cell deletion toast to undo, and add to command pallete and notebook actions by mscolnick in https://github.com/marimo-team/marimo/pull/1209
* fix: Interrupts on Windows by akshayka in https://github.com/marimo-team/marimo/pull/1210
* fix: check for __file__ on main by akshayka in https://github.com/marimo-team/marimo/pull/1211
* fix: graalpy by akshayka in https://github.com/marimo-team/marimo/pull/1212
* fix: race condition in module watcher by akshayka in https://github.com/marimo-team/marimo/pull/1213
* fix: close matplotlib figures in app.run() by akshayka in https://github.com/marimo-team/marimo/pull/1215
* fix: don't load marimo mpl backend in script context by akshayka in https://github.com/marimo-team/marimo/pull/1216
* fix: graceful exit when running as a script by akshayka in https://github.com/marimo-team/marimo/pull/1217
* fix: give real UIElementRegistry when running as a script by akshayka in https://github.com/marimo-team/marimo/pull/1218
* fix: explicit field types for mo.ui.dataframe by mscolnick in https://github.com/marimo-team/marimo/pull/1144
* improvement: tab to start completion by akshayka in https://github.com/marimo-team/marimo/pull/1220
* fix: flatten subtype by akshayka in https://github.com/marimo-team/marimo/pull/1221
* fix: syntax error handling in module reloading by akshayka in https://github.com/marimo-team/marimo/pull/1222
* 0.4.4 by akshayka in https://github.com/marimo-team/marimo/pull/1223


**Full Changelog**: https://github.com/marimo-team/marimo/compare/0.4.3...0.4.4

What's Changed

Highlights

This release adds `mo.ui.range_slider` — thanks wasimsandhu for your contribution! It also includes performance improvements
and bug fixes.

Full changelog

* fix: prune directories from os.walk search by akshayka in https://github.com/marimo-team/marimo/pull/1189
* fix: only check newly loaded modules after execution by akshayka in https://github.com/marimo-team/marimo/pull/1190
* doc improvements by akshayka in https://github.com/marimo-team/marimo/pull/1191
* Bump timeout by akshayka in https://github.com/marimo-team/marimo/pull/1196
* feat: Create range slider component by wasimsandhu in https://github.com/marimo-team/marimo/pull/1193
* improve module reloader performance by akshayka in https://github.com/marimo-team/marimo/pull/1197
* improvement: colorize traceback by mscolnick in https://github.com/marimo-team/marimo/pull/1198
* [experimental] marimo islands by mscolnick in https://github.com/marimo-team/marimo/pull/1195
* fix: don't fail if searching for marimo apps fail on a file by mscolnick in https://github.com/marimo-team/marimo/pull/1201
* fix: fix marimo islands header urls by mscolnick in https://github.com/marimo-team/marimo/pull/1200
* 0.4.3 by akshayka in https://github.com/marimo-team/marimo/pull/1203


**Full Changelog**: https://github.com/marimo-team/marimo/compare/0.4.2...0.4.3

What's Changed

This version includes improvements to `mo.ui.plotly`, the module autoreloader, `mo.status.progress_bar`, as well as other bug fixes.

Full changelog

* improvement: support plotly config and renderers by mscolnick in https://github.com/marimo-team/marimo/pull/1170
* fix: fix edge case with packages and autoreload by akshayka in https://github.com/marimo-team/marimo/pull/1172
* fix: Issue574 by metaboulie in https://github.com/marimo-team/marimo/pull/1159
* fix recipe doc by akshayka in https://github.com/marimo-team/marimo/pull/1180
* fix: catch base exceptions by akshayka in https://github.com/marimo-team/marimo/pull/1178
* fix: ignore third-party packages in module watcher by akshayka in https://github.com/marimo-team/marimo/pull/1179
* fix: clear plotly selection (double click) by mscolnick in https://github.com/marimo-team/marimo/pull/1181
* Slightly bigger latex by akshayka in https://github.com/marimo-team/marimo/pull/1182
* add a bit more info about outputs to docs by akshayka in https://github.com/marimo-team/marimo/pull/1184
* docs: add search and icons to the header by mscolnick in https://github.com/marimo-team/marimo/pull/1183
* fix: don't install interrupt signal handler in run mode by akshayka in https://github.com/marimo-team/marimo/pull/1185
* 0.4.2 by akshayka in https://github.com/marimo-team/marimo/pull/1187

New Contributors
* metaboulie made their first contribution in https://github.com/marimo-team/marimo/pull/1159

**Full Changelog**: https://github.com/marimo-team/marimo/compare/0.4.1...0.4.2

What's Changed

Highlights

⚡️ **Reactive module autoreloading.** marimo now ships with the **most advanced module autoreloader** out of any interactive Python programming environment. When enabled (via the notebook settings menu), marimo automatically react to modifications made to packages and modules that your notebook imports. This lets you develop complex logic in Python modules, using an editor of your choice, and use the marimo notebook as a DAG or main script that orchestrates your logic.

Autoreloading comes in two flavors:

- **“detect”**: automatically marks cells affected by module modifications as stale, letting you know which cells need to be re-run.
- **“autorun”**: automatically re-runs cells affected by module modification.

Thanks MartinBernstorff, astrowonk for the feature request!

⛓ **Command-line arguments**. Give arbitrary command-line arguments to your notebook, and read them with [`mo.cli_args()`](https://docs.marimo.io/api/cli_args.html): this works in `edit` and `run` modes, and also while running as a script.

- `marimo edit notebook.py -- -arg1=foo -arg2=bar`
- `marimo run notebook.py -- -arg1=foo -arg2=bar`
- `python notebook.py -arg1=foo -arg2=bar`

Thanks twrightsman for the feature request!

📄 **Programmatic HTML export**. Long requested, finally here: use `marimo export html` at the command-line to export your notebooks as beautiful documents:

- to HTML: `marimo export html notebook.py -o notebook.html`
- with CLI args: `marimo export html notebook.py -o notebook.html -- -arg1=foo -arg2=bar`

Thanks egemenimre, scls19fr, bmeyers for the feature request!

🔎 **Check if running in a notebook.** Use `mo.running_in_notebook()` to tell whether Python is executing inside a marimo notebook. Use this when developing library code that integrates with marimo, or to tell whether your notebook file is running via the notebook kernel or as a Python script.

P.S. Check out our new guide on [integrating your objects with marimo](https://docs.marimo.io/guides/integrating_with_marimo/index.html).

Full changelog

* fix: latex line-height by mscolnick in https://github.com/marimo-team/marimo/pull/1136
* fix: send app-config in kernel ready response by mscolnick in https://github.com/marimo-team/marimo/pull/1133
* improvement: move html export logic to python code by mscolnick in https://github.com/marimo-team/marimo/pull/1135
* feat: reactive reloading of modified modules by akshayka in https://github.com/marimo-team/marimo/pull/1139
* refactor parse_dataclass.py by fuenfundachtzig in https://github.com/marimo-team/marimo/pull/1082
* chore: use ruff to auto add returns by mscolnick in https://github.com/marimo-team/marimo/pull/1143
* feat: marimo export html cli by mscolnick in https://github.com/marimo-team/marimo/pull/1141
* fix: use data urls for vfiles when running as a script by akshayka in https://github.com/marimo-team/marimo/pull/1145
* Update deploying_docker.md by jettil in https://github.com/marimo-team/marimo/pull/1147
* feat: mo.cli_args by mscolnick in https://github.com/marimo-team/marimo/pull/1146
* improvement: running as script - only start event loop when needed by akshayka in https://github.com/marimo-team/marimo/pull/1148
* feat: add cli args to html export by akshayka in https://github.com/marimo-team/marimo/pull/1151
* improvement: modernize filename dropdown by mscolnick in https://github.com/marimo-team/marimo/pull/1153
* fix: grid editor when bordered by mscolnick in https://github.com/marimo-team/marimo/pull/1154
* feat: CLI args when running as a script by akshayka in https://github.com/marimo-team/marimo/pull/1150
* feat: mo.running_in_notebook() by akshayka in https://github.com/marimo-team/marimo/pull/1155
* chore: add marimo shields by mscolnick in https://github.com/marimo-team/marimo/pull/1156
* chore: ignore /var tmp directory in homepage by akshayka in https://github.com/marimo-team/marimo/pull/1157
* fix: dont drop async prefix when re-formatting cell signature by akshayka in https://github.com/marimo-team/marimo/pull/1167
* docs: integrations guide by akshayka in https://github.com/marimo-team/marimo/pull/1158
* fix: fix plotly re-rendering and re-mounting state by mscolnick in https://github.com/marimo-team/marimo/pull/1169
* 0.4.1 by akshayka in https://github.com/marimo-team/marimo/pull/1168

New Contributors
* jettil made their first contribution in https://github.com/marimo-team/marimo/pull/1147

**Full Changelog**: https://github.com/marimo-team/marimo/compare/0.4.0...0.4.1

What's Changed

Highlights

🏠 **Edit multiple notebooks with marimo edit!**: `marimo edit` now opens a notebook homepage that lets you create new notebooks, and start and stop exiting ones. That is, this homepage gives you a single marimo server to edit multiple notebooks.

You can still use `marimo edit notebook.py` to edit a specific notebook. To create a new notebook without going through the notebook server, use `marimo new`.

This feature is new and will evolve rapidly — please give us your feedback!

<img width="997" alt="image" src="https://github.com/marimo-team/marimo/assets/1994308/690484bc-95e4-4864-8ebb-6bb146f46d99">

🗂️ **File browser**: Use `mo.ui.file_browser` to add an interactive file browser to your notebooks! Thanks wasimsandhu for the contribution!

**Quality-of-life improvements**: Version 0.4.0 includes accessibility updates to `mo.ui.number`, lets you format notebooks with `ruff` (in addition to Black), and other small improvements.

All changes

* marimo for Jupyter users tutorial by akshayka in https://github.com/marimo-team/marimo/pull/1104
* fix: Fix handling of None and empty values in QueryParams class by mscolnick in https://github.com/marimo-team/marimo/pull/1111
* improvement: improved number input by mscolnick in https://github.com/marimo-team/marimo/pull/1109
* UX hint for live docs by akshayka in https://github.com/marimo-team/marimo/pull/1114
* fix: brodered grid on overflow by mscolnick in https://github.com/marimo-team/marimo/pull/1113
* feat: homepage / multi-file router while editing by mscolnick in https://github.com/marimo-team/marimo/pull/1100
* chore: bump ruff, add more rules by mscolnick in https://github.com/marimo-team/marimo/pull/1115
* chore: ruff format by mscolnick in https://github.com/marimo-team/marimo/pull/1116
* chore: use uv in CI by mscolnick in https://github.com/marimo-team/marimo/pull/1117
* improvement: add full_width option to slider by akshayka in https://github.com/marimo-team/marimo/pull/1120
* chore: upgrade storybook by mscolnick in https://github.com/marimo-team/marimo/pull/1119
* feat: format with ruff if provided, black is not by mscolnick in https://github.com/marimo-team/marimo/pull/1118
* feat: Create file browser component by wasimsandhu in https://github.com/marimo-team/marimo/pull/1106
* fix slider styling by akshayka in https://github.com/marimo-team/marimo/pull/1122
* fix: storybook builds by mscolnick in https://github.com/marimo-team/marimo/pull/1124
* chore: enable more ruff rules by mscolnick in https://github.com/marimo-team/marimo/pull/1121
* fixed "AssertionError: .value can only be used after the context manager exits by fuenfundachtzig in https://github.com/marimo-team/marimo/pull/1129
* fix: home-page followups by mscolnick in https://github.com/marimo-team/marimo/pull/1128
* improvement: special case list formatter for matplotlib. by akshayka in https://github.com/marimo-team/marimo/pull/1130
* fix: add notebook's current directory to path by akshayka in https://github.com/marimo-team/marimo/pull/1132
* docs: marimo edit - homepage by akshayka in https://github.com/marimo-team/marimo/pull/1125
* 0.4.0 by akshayka in https://github.com/marimo-team/marimo/pull/1134


**Full Changelog**: https://github.com/marimo-team/marimo/compare/0.3.12...0.4.0

What's Changed

A small bug-fix for release 0.3.11, which has many interesting new features.

* chore: e2e - count() -> toHaveCount() by akshayka in https://github.com/marimo-team/marimo/pull/1097
* fix: snippet endpoint by akshayka in https://github.com/marimo-team/marimo/pull/1098
* 0.3.12 by akshayka in https://github.com/marimo-team/marimo/pull/1099


**Full Changelog**: https://github.com/marimo-team/marimo/compare/0.3.11...0.3.12