Marimo

What's Changed

For a deep dive into this release, check out our [blog post](https://marimo.io/blog/marimo-0-9-0).

Breaking changes

This release drops support for Python 3.8, which has reached its end-of-life.

Highlights

- 💬 **Custom chatbots**: Create custom chatbots with [mo.ui.chat](https://docs.marimo.io/api/inputs/chat.html), a reactive chat component
- ✨ **Gemini support**: marimo’s [built-in AI assistant](https://docs.marimo.io/guides/editor_features/ai_completion.html#generate-code-with-our-ai-assistant) now supports Google’s Gemini model
- 💾 **Smart caching**: marimo now ships with [opt-in caching](https://docs.marimo.io/api/caching.html#caching-variables-to-disk) that lets you shut down or re-run notebooks and pick up where you left off, instantly loading variables in memory instead of recomputing them.

All changes

* fix: pin version to current marimo version in sandbox by mscolnick in https://github.com/marimo-team/marimo/pull/2447
* improvement: allow more package installation rules in the pkg management UI by mscolnick in https://github.com/marimo-team/marimo/pull/2448
* chore: upgrade pnpm v9 by mscolnick in https://github.com/marimo-team/marimo/pull/2450
* feat: mo.ui.chat() by mscolnick in https://github.com/marimo-team/marimo/pull/2436
* fix: mangle node.asname for imports by akshayka in https://github.com/marimo-team/marimo/pull/2452
* [pre-commit.ci] pre-commit autoupdate by pre-commit-ci in https://github.com/marimo-team/marimo/pull/2454
* Docs: Add guide to Codeium API key from VS Code by rparkr in https://github.com/marimo-team/marimo/pull/2458
* improvement: add -o to marimo convert CLI by mscolnick in https://github.com/marimo-team/marimo/pull/2461
* improvement: add on-module-change footer config by mscolnick in https://github.com/marimo-team/marimo/pull/2462
* improvement: support sunburst and treemap plotly selection by mscolnick in https://github.com/marimo-team/marimo/pull/2463
* feat: add `mo.notebook_dir()`. avoid relative paths for better reproducibility by mscolnick in https://github.com/marimo-team/marimo/pull/2464
* feat: marimo.cache + tests and documentation by dmadisetti in https://github.com/marimo-team/marimo/pull/2318
* Remove 3.8 support by akshayka in https://github.com/marimo-team/marimo/pull/2467
* Update AutoExporter directory to __marimo__ by akshayka in https://github.com/marimo-team/marimo/pull/2468
* Use notebook directory in persistent_cache by akshayka in https://github.com/marimo-team/marimo/pull/2469
* fix: broken screenshot links in docs by rparkr in https://github.com/marimo-team/marimo/pull/2472
* Document support for IPython `_repr_*_()_` protocol by akshayka in https://github.com/marimo-team/marimo/pull/2470
* fix: opening nested files with 'marimo edit <dir>' by mscolnick in https://github.com/marimo-team/marimo/pull/2477
* fix: honor show_column_summaries by mscolnick in https://github.com/marimo-team/marimo/pull/2475
* fix: open running notebooks in new tab on the homepage by mscolnick in https://github.com/marimo-team/marimo/pull/2476
* added python executable to pip and uv by liquidcarbon in https://github.com/marimo-team/marimo/pull/2478
* feat: support gemini in AI Assist and mo.ui.chat() by mscolnick in https://github.com/marimo-team/marimo/pull/2479
* fix: reactive ui.chat, add examples by akshayka in https://github.com/marimo-team/marimo/pull/2482
* fix: handle shadowed variables in mo.cache, update tutorials by akshayka in https://github.com/marimo-team/marimo/pull/2480
* 0.9.0 by akshayka in https://github.com/marimo-team/marimo/pull/2490

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

**Full Changelog**: https://github.com/marimo-team/marimo/compare/0.8.22...0.9.0

What's Changed

- Important bug fixes for running sandboxed notebooks
- Possible performance improvement for edit mode

* Force asyncio in edit mode by akshayka in https://github.com/marimo-team/marimo/pull/2442
* fix: ignore warning for finding dependencies in new files by mscolnick in https://github.com/marimo-team/marimo/pull/2444
* fix: in sandbox, skip sandbox prompt if possible by akshayka in https://github.com/marimo-team/marimo/pull/2445


**Full Changelog**: https://github.com/marimo-team/marimo/compare/0.8.21...0.8.22

What's Changed

Highlights ✨

🪐 ➡️ 🍃 **A new and improved auto-converter from Jupyter to marimo.** This release substantially improves our tool for converting Jupyter notebooks to marimo notebooks — you no longer have to resolve multiple definition errors on your own, and some popular magic commands are replaced with marimo equivalents.

Try it at the command-line: `marimo convert nb.ipynb > nb.py`.

Converting from Jupyter to marimo gets you freebies like a much more powerful [dataframe viewer](https://docs.marimo.io/guides/dataframes.html) and [editor](https://docs.marimo.io/guides/editor_features/index.html) (including GitHub copilot, AI completion, and data source panels), with zero effort required on your part.

📦 **Making it easier to start [sandboxed notebooks](https://marimo.io/blog/sandboxed-notebooks).** If a notebook encapsulates its own dependencies, marimo now prompts you to open it an a temporary venv, with its packages automatically installed:

✅ **`-y` option for our CLI.**  Adds a CLI `-y` option that when enabled automatically confirms "yes" for interactive prompts.

🖱️**Multi-select improvements** Select and unselect all, with one click.

All changes

* move gitpod to contributing by akshayka in https://github.com/marimo-team/marimo/pull/2408
* fix: staleness in mo.ui.table() when using UI elements by mscolnick in https://github.com/marimo-team/marimo/pull/2409
* styles: increase slides default font-size to 80px by mscolnick in https://github.com/marimo-team/marimo/pull/2411
* fix: restore users custom rcparams by akshayka in https://github.com/marimo-team/marimo/pull/2410
* improve: prompt to run in sandbox when appropriate by akshayka in https://github.com/marimo-team/marimo/pull/2412
* examples: sidebar and slides examples by mscolnick in https://github.com/marimo-team/marimo/pull/2417
* fix: install inline-metadata for remote deps by mscolnick in https://github.com/marimo-team/marimo/pull/2416
* Fixes to layout examples by akshayka in https://github.com/marimo-team/marimo/pull/2418
* examples: grid dashboard by mscolnick in https://github.com/marimo-team/marimo/pull/2419
* improvement: track duckdb.sql and duckdb.execute SQL statements in dep graph by mscolnick in https://github.com/marimo-team/marimo/pull/2427
* fix: don't allow install/uninstall if package manager doesn't exist, better warnings by mscolnick in https://github.com/marimo-team/marimo/pull/2428
* improvement: patch plotly show to open in the notebook by mscolnick in https://github.com/marimo-team/marimo/pull/2423
* improvement: remove bounds on number, add warnings and validation by mscolnick in https://github.com/marimo-team/marimo/pull/2429
* improvement: add multiple dependencies and pressing ENTER for package manager by mscolnick in https://github.com/marimo-team/marimo/pull/2431
* improvement: add select all and deselect all to multi-select by mscolnick in https://github.com/marimo-team/marimo/pull/2433
* improvement: improve convert with smart renaming, magics, dedupe imports, and more by mscolnick akshayka in https://github.com/marimo-team/marimo/pull/2422
* 0.8.21 by akshayka in https://github.com/marimo-team/marimo/pull/2439


**Full Changelog**: https://github.com/marimo-team/marimo/compare/0.8.20...0.8.21

What's Changed

✨ Highlights

📦 **Package manager panel.** This release adds a new panel — the package manager panel. From this panel, you can view all packages installed in your environment, as well as add and remove packages. When running with `--sandbox`, adding and removing packages also updates your notebook's inline script metadata.


🖼️ **`mo.iframe()`**: Use [`mo.iframe`](https://docs.marimo.io/api/html.html#marimo.iframe) to create iframes that properly resize their content.

All changes

* [pre-commit.ci] pre-commit autoupdate by pre-commit-ci in https://github.com/marimo-team/marimo/pull/2393
* fix: Don't remove packages when imports removed from notebook in sandbox by akshayka in https://github.com/marimo-team/marimo/pull/2396
* feat: panel for packagemanagement by mscolnick in https://github.com/marimo-team/marimo/pull/2392
* feat: add mo.iframe, and a-frame example by mscolnick in https://github.com/marimo-team/marimo/pull/2398
* fix: emit some errors to stderr by akshayka in https://github.com/marimo-team/marimo/pull/2399
* improve: examples by akshayka in https://github.com/marimo-team/marimo/pull/2400
* Update README.md by akshayka in https://github.com/marimo-team/marimo/pull/2401
* docs improvements by akshayka in https://github.com/marimo-team/marimo/pull/2402
* 0.8.20 by akshayka in https://github.com/marimo-team/marimo/pull/2407


**Full Changelog**: https://github.com/marimo-team/marimo/compare/0.8.19...0.8.20

What's Changed

Highlights

🥧 **pyecharts support**: You can now use [pyecharts](https://github.com/pyecharts/pyecharts) in marimo!
🛠️ **`marimo run` reliability**: This release fixes [an issue](https://github.com/marimo-team/marimo/issues/1568) some users saw when running marimo apps in production.
📦 **Package manager improvements**: marimo's package installer now lets you [choose a package version](https://github.com/marimo-team/marimo/pull/2385).
🏠 **XDG-compliant configuration.** marimo's local configuration is now XDG compliant. Thanks pakelley for the contribution!

All changes

* fix: hide floating outline if less than 2 items by mscolnick in https://github.com/marimo-team/marimo/pull/2375
* feat: xdg config file by pakelley in https://github.com/marimo-team/marimo/pull/2367
* feat: pyecharts support by mscolnick in https://github.com/marimo-team/marimo/pull/2383
* fix: sql parsing and polars date summaries by mscolnick in https://github.com/marimo-team/marimo/pull/2382
* docs: symlink docs by mscolnick in https://github.com/marimo-team/marimo/pull/2386
* improvement: allow .style() to take kwargs, add tests by mscolnick in https://github.com/marimo-team/marimo/pull/2380
* fix: disable pdf export while editing by mscolnick in https://github.com/marimo-team/marimo/pull/2387
* feat: support installing packages at particular versions in the UI by mscolnick in https://github.com/marimo-team/marimo/pull/2385
* Refactor communication between server/kernels to use queues in run mode by akshayka in https://github.com/marimo-team/marimo/pull/2379
* 0.8.19 by akshayka in https://github.com/marimo-team/marimo/pull/2391

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

**Full Changelog**: https://github.com/marimo-team/marimo/compare/0.8.18...0.8.19

What's Changed

Quality of life improvements and fixes, as well as a new feature:

🍞 Use `mo.status.toast()` to render ephemeral alerts 🚨

All changes

* fix: allow mo.status.spinner and mo.state.progress to noop outside marimo by mscolnick in https://github.com/marimo-team/marimo/pull/2352
* fix: support import doctest; doctest.testmod() by mscolnick in https://github.com/marimo-team/marimo/pull/2353
* chore: format tuple in return to match ruff/black by akshayka in https://github.com/marimo-team/marimo/pull/2351
* docs: add additional docs coming from jupytext, papermill, streamlit by mscolnick in https://github.com/marimo-team/marimo/pull/2356
* fix: encoding table elements when passed through RPC calls by mscolnick in https://github.com/marimo-team/marimo/pull/2358
* fix: don't hide cell actions when in full-width mode by mscolnick in https://github.com/marimo-team/marimo/pull/2360
* improvement: add hash to html export by mscolnick in https://github.com/marimo-team/marimo/pull/2359
* fix2364: implement marimo.status.toast by metaboulie in https://github.com/marimo-team/marimo/pull/2365
* fix: handling of buffer paths in Anywidget by mscolnick in https://github.com/marimo-team/marimo/pull/2368
* docs: troubleshooting by mscolnick in https://github.com/marimo-team/marimo/pull/2371
* fix: better plotly deselect by mscolnick in https://github.com/marimo-team/marimo/pull/2372
* fix: don't block homepage on workspace files. add timeout and error banner by mscolnick in https://github.com/marimo-team/marimo/pull/2373
* 0.8.18 by akshayka in https://github.com/marimo-team/marimo/pull/2374


**Full Changelog**: https://github.com/marimo-team/marimo/compare/0.8.17...0.8.18