Marimo

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

What's Changed

New Features

**Autoreload modules.** marimo can now be configured to automatically reload modules before executing cells, bringing in any modifications you may have made to modules used by your notebook.

If you're coming from IPython/Jupyter, this is similar to the `autoreload 2` magic.

Enable it in your settings:

https://github.com/marimo-team/marimo/assets/1994308/3b2aea42-4fdc-40cd-b9e7-11e6455465ba

**Snippets.** marimo now ships with a library of code snippets that you may find useful when working with data. Open the snippets panel via the toolbar at the bottom of a marimo notebook. We'll add more snippets over time; if there's a snippet you'd like to contribute, just click the `+` button in the snippets panel to send it our way.


https://github.com/marimo-team/marimo/assets/1994308/63f607b3-ac0d-4f55-b4da-bad648810ab8

Other improvements

**`mo.audio`**: you can now pass a path to a file to `mo.audio`, and it'll do the right thing. This function now accepts arbitrarily large audio files.

**`PyArrow` tables**: `mo.ui.table()` now supports `PyArrow` tables.

All changes

* performance: pyodide code completion by akshayka in https://github.com/marimo-team/marimo/pull/1084
* fix: inifinite resize by mscolnick in https://github.com/marimo-team/marimo/pull/1087
* fix: dont use mpl backend when running as a script by akshayka in https://github.com/marimo-team/marimo/pull/1089
* feat: snippets panel by mscolnick in https://github.com/marimo-team/marimo/pull/1069
* improvement: large audio files by akshayka in https://github.com/marimo-team/marimo/pull/1090
* feat: support pyarrow and column major data in mo.ui.table by mscolnick in https://github.com/marimo-team/marimo/pull/1091
* Change test order in Makefile by fuenfundachtzig in https://github.com/marimo-team/marimo/pull/1095
* Address issue 1004 ("\n in mo.md literally interperted in markdown mode") by fuenfundachtzig in https://github.com/marimo-team/marimo/pull/1038
* feat: autoreload by akshayka in https://github.com/marimo-team/marimo/pull/1092
* 0.3.11 by akshayka in https://github.com/marimo-team/marimo/pull/1096


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

What's Changed

Quality-of-life improvements to `mo.ui.file`, and misc. bug fixes.

* fix: jedi stack overflow bug by akshayka in https://github.com/marimo-team/marimo/pull/1066
* pip install openai in docs by akshayka in https://github.com/marimo-team/marimo/pull/1068
* fix: sort routes in create_asgi_app by mscolnick in https://github.com/marimo-team/marimo/pull/1067
* Better styling of file upload area by akshayka in https://github.com/marimo-team/marimo/pull/1070
* fix: add mapping for cv2 module by akshayka in https://github.com/marimo-team/marimo/pull/1074
* Fix: close pdb inputs after resolved by akshayka in https://github.com/marimo-team/marimo/pull/1076
* improvement: mo.ui.file upload confirmation, removal by akshayka in https://github.com/marimo-team/marimo/pull/1077
* chore: silence some type errors by akshayka in https://github.com/marimo-team/marimo/pull/1079
* 0.3.10 by akshayka in https://github.com/marimo-team/marimo/pull/1081


**Full Changelog**: https://github.com/marimo-team/marimo/compare/0.3.9...0.3.10