Marimo

What's Changed

**✨ Text to notebook!** This release adds an exciting new feature: generate notebooks with a zero-shot prompt using an LLM, straight from the command line. This uses the same endpoint we've hosted at https://marimo.app/ai, but in the future we may extend to allow your own endpoints.

To get started, just type `marimo new "your prompt here"`. For example:


marimo new "Plot an interesting 3D surface with matplotlib. Include an interactive element to control the shape of the surface."


The marimo notebook generator can make use of marimo UI elements, and is aware of rules governing usage of variables in marimo. So feel free to get creative, and send us your favorite prompts at https://marimo.io/discord!

For example prompts, check out https://marimo.app/ai.

All changes

* feat: marimo new 'prompt to generate notebook' by mscolnick in https://github.com/marimo-team/marimo/pull/4364
* fix: remove none vals from being written to toml by Light2Dark in https://github.com/marimo-team/marimo/pull/4373
* fix: Vim Ctrl+[ to Escape by mscolnick in https://github.com/marimo-team/marimo/pull/4361
* fix: vscode bindings since they removed execCommand by mscolnick in https://github.com/marimo-team/marimo/pull/4377


**Full Changelog**: https://github.com/marimo-team/marimo/compare/0.12.2...0.12.3

Highlights ⭐

* **Environment variables** - in beta behind a feature flag. There is a new panel to read/write environment variables. This will be extended to more Secret Providers in the future.
* **Trino support** - You can now add a Trino connection from the database connection UI.

What's Changed
* fix: use max_completion_tokens instead of max_tokens by mscolnick in https://github.com/marimo-team/marimo/pull/4328
* fix: patch bokeh.io.show by mscolnick in https://github.com/marimo-team/marimo/pull/4327
* chore(deps): update dependency vite to v6.2.4 [security] by renovate in https://github.com/marimo-team/marimo/pull/4330
* feat: show dropdown of environment keys in DB Connection UI by mscolnick in https://github.com/marimo-team/marimo/pull/4329
* mep/8: Formatting for library serialization by dmadisetti in https://github.com/marimo-team/marimo/pull/4333
* improvement: add TextIteratorStreamer formatter from Hugging Face by mscolnick in https://github.com/marimo-team/marimo/pull/4336
* docs: update argparse example by akshayka in https://github.com/marimo-team/marimo/pull/4341
* chore(deps): update dependency sqlalchemy to >=2.0.40 by renovate in https://github.com/marimo-team/marimo/pull/4338
* chore(deps): update dependency pyarrow to >=19.0.1 by renovate in https://github.com/marimo-team/marimo/pull/4337
* chore(deps): update dependency clickhouse-connect to >=0.8.16 by renovate in https://github.com/marimo-team/marimo/pull/4335
* fix(deps): update all npm non-major dependencies by renovate in https://github.com/marimo-team/marimo/pull/4342
* chore(deps): update dependency anywidget to ~=0.9.18 by renovate in https://github.com/marimo-team/marimo/pull/4334
* fix: image popover regression by Light2Dark in https://github.com/marimo-team/marimo/pull/4339
* feat: secrets panel by mscolnick in https://github.com/marimo-team/marimo/pull/4348
* improvement: latex syntax highlighting by mscolnick in https://github.com/marimo-team/marimo/pull/4346
* feat: add trino support by Light2Dark in https://github.com/marimo-team/marimo/pull/4340
* fix: col names missing for chdb by Light2Dark in https://github.com/marimo-team/marimo/pull/4355
* feat: write env vars from secrets panel by mscolnick in https://github.com/marimo-team/marimo/pull/4349
* mep/8: Add app.class_definition by dmadisetti in https://github.com/marimo-team/marimo/pull/4353
* fix: downgrade react-hook-form by mscolnick in https://github.com/marimo-team/marimo/pull/4357
* Correct minor punctuation error by tmct in https://github.com/marimo-team/marimo/pull/4358
* fix: completion after . by mscolnick in https://github.com/marimo-team/marimo/pull/4359

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

**Full Changelog**: https://github.com/marimo-team/marimo/compare/0.12.0...0.12.1

Highlights ⭐

- Latex completions in markdown mode
- Environment variables are automatically loaded dot-env files (e.g. `.env`) next to your `pyproject.toml`. You can customize this with:

toml
[tool.marimo.runtime]
dotenv = [] don't load any
dotenv = [".env"] default
dotenv = [".env", ".env.production"] load multiple

- Support for using argparse and simple-parsing in marimo notebooks: letting you make notebooks that double as scripts with help messages and argument validation. See [our examples](https://github.com/marimo-team/marimo/tree/6f8d6cb94c6f1d9a85f5abfc04208cbbd0a1d179/examples/running_as_a_script) and [documentation](https://docs.marimo.io/guides/scripts/) to learn more.

This feature was contributed by lucharo!

Breaking changes

1. This release contains a small breaking change. `sys.argv` is now patched to the args after the marimo command

For example, for

bash
marimo edit notebook.py -- foo bar -baz 42

`sys.argv` would be set to

bash
["notebook.py", "foo", "bar", "-baz", "42"]


2. Environment variables are loaded from your `.env` by default. This can be removed through configuration.

What's Changed
* docs: cli arguments by akshayka in https://github.com/marimo-team/marimo/pull/4304
* docs: update intro.py by GadgetSteve in https://github.com/marimo-team/marimo/pull/4259
* fix: create public folder and then file by Light2Dark in https://github.com/marimo-team/marimo/pull/4299
* feat: argparse support when running as a notebook by akshayka in https://github.com/marimo-team/marimo/pull/4306
* improvement: format using popover for long strings by Light2Dark in https://github.com/marimo-team/marimo/pull/4298
* feat: utf-8 latex completions by mscolnick in https://github.com/marimo-team/marimo/pull/4302
* feat: Automatically loading env vars using dotenv + specify custom env files by lucharo in https://github.com/marimo-team/marimo/pull/4280
* improvement: start of secrets handling in the kernel by mscolnick in https://github.com/marimo-team/marimo/pull/4301
* improvement: dataflow perf by mscolnick in https://github.com/marimo-team/marimo/pull/4313
* docs: hstack width examples by mscolnick in https://github.com/marimo-team/marimo/pull/4314
* improve: stale indicator precedence over error by akshayka in https://github.com/marimo-team/marimo/pull/4321
* fix: markdown details justification by akshayka in https://github.com/marimo-team/marimo/pull/4322
* fix: clamp wide elements in slides by Light2Dark in https://github.com/marimo-team/marimo/pull/4325

New Contributors
* GadgetSteve made their first contribution in https://github.com/marimo-team/marimo/pull/4259
* lucharo made their first contribution in https://github.com/marimo-team/marimo/pull/4280

**Full Changelog**: https://github.com/marimo-team/marimo/compare/0.11.31...0.12.0

This release includes lot lots of table improvements. You can now drop images directly in markdown and the file will be copied, instead of encoded as base64.

What's Changed
* docs: fix example for stat by Light2Dark in https://github.com/marimo-team/marimo/pull/4274
* fix: allow mo.stop in scripts by akshayka in https://github.com/marimo-team/marimo/pull/4273
* fix: nans allowed in column summaries by akshayka in https://github.com/marimo-team/marimo/pull/4272
* chore(deps): update all storybook dependencies to ^8.6.9 by renovate in https://github.com/marimo-team/marimo/pull/4281
* improvement: automatically add lsp in sandbox mode when running 'marimo edit' by mscolnick in https://github.com/marimo-team/marimo/pull/4279
* fix: the lookback that LSP completions replaces by mscolnick in https://github.com/marimo-team/marimo/pull/4283
* feat: styling cells in mo.ui.table by nojaf in https://github.com/marimo-team/marimo/pull/4245
* fix: date serialization in altair without timezones by mscolnick in https://github.com/marimo-team/marimo/pull/4286
* fix: next page & styling of cells by Light2Dark in https://github.com/marimo-team/marimo/pull/4294
* add an alias to ffmpeg-python module by jonassvatos in https://github.com/marimo-team/marimo/pull/4293
* improve: cached session invalidation by akshayka in https://github.com/marimo-team/marimo/pull/4284
* improvement: include PIL images in mo.ui.table() by mscolnick in https://github.com/marimo-team/marimo/pull/4285
* improvement: support dropping or copying base64 image files by Light2Dark in https://github.com/marimo-team/marimo/pull/4291
* fix: build copilot lsp as .cjs by mscolnick in https://github.com/marimo-team/marimo/pull/4297

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

**Full Changelog**: https://github.com/marimo-team/marimo/compare/0.11.30...0.11.31

What's Changed
* fix: cache kwargs regression in 3480 by dmadisetti in https://github.com/marimo-team/marimo/pull/4255
* fix: unable to download csv/json for no selection by Light2Dark in https://github.com/marimo-team/marimo/pull/4262
* fix: custom config used for inline-completions with ollama by mscolnick in https://github.com/marimo-team/marimo/pull/4257
* feat: add clickhouse db panel by Light2Dark in https://github.com/marimo-team/marimo/pull/4261
* fix: import dataclass correctly by Light2Dark in https://github.com/marimo-team/marimo/pull/4265
* improvement: allow turning on the LSP without restarting the server by mscolnick in https://github.com/marimo-team/marimo/pull/4266
* docs: add mo.stat by Light2Dark in https://github.com/marimo-team/marimo/pull/4267
* improvement : Adding functionality to handle numpy array as src in mo.audio simliar to ipython audio by xeniumcode in https://github.com/marimo-team/marimo/pull/4247
* tests: mo.audio by mscolnick in https://github.com/marimo-team/marimo/pull/4268
* chore(deps): update all storybook dependencies to ^8.6.8 by renovate in https://github.com/marimo-team/marimo/pull/4270
* feat: show JSON objects in cell using raw data by dmytrohoi in https://github.com/marimo-team/marimo/pull/4219
* fix: fallback to pandas sql by Light2Dark in https://github.com/marimo-team/marimo/pull/4271

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

**Full Changelog**: https://github.com/marimo-team/marimo/compare/0.11.28...0.11.29

What's Changed
* docs: touch up marimo snippets by akshayka in https://github.com/marimo-team/marimo/pull/4253
* fix: completions no appearing b/c of live docs. don't request live-docs unless open by mscolnick in https://github.com/marimo-team/marimo/pull/4254


**Full Changelog**: https://github.com/marimo-team/marimo/compare/0.11.27...0.11.28