Marimo

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

What's Changed

* 🐍 **Python 3.13.** This release adds official Python 3.13 support.
* 🛢️ **Clickhouse support.** Query Clickhouse using our built-in SQL cells. See [the PR](https://github.com/marimo-team/marimo/pull/4185) for more info.
* 🧩 **Rich elements in tables.** `mo.ui.table()` and the built-in dataframe viewer now render other marimo elements using their rich representation.

All changes

* chore(deps): update build tools by renovate in https://github.com/marimo-team/marimo/pull/4211
* improvement: default altair charts to full width, add typechecking by mscolnick in https://github.com/marimo-team/marimo/pull/4205
* feat: show rich elems in datatables by Light2Dark in https://github.com/marimo-team/marimo/pull/4204
* fix: getting stuck waiting for socket to connect by etrotta in https://github.com/marimo-team/marimo/pull/4213
* fix: nulls not showing when toggling app view by akshayka in https://github.com/marimo-team/marimo/pull/4221
* fix: change back to csv parsing for data editor by Light2Dark in https://github.com/marimo-team/marimo/pull/4227
* improv: privatize mime bundle by Light2Dark in https://github.com/marimo-team/marimo/pull/4225
* feat: python 3.13 support by mscolnick in https://github.com/marimo-team/marimo/pull/4193
* Adding IntoSeries which is now implemented in narwhals by xeniumcode in https://github.com/marimo-team/marimo/pull/4215
* improvement: Adding config option for SSL/TLS-secured OpenAI-compatible API/AI assistants by xeniumcode in https://github.com/marimo-team/marimo/pull/4201
* chore: cleanup importfiles by mscolnick in https://github.com/marimo-team/marimo/pull/4212
* fix: pytest bugs from user feedback by dmadisetti in https://github.com/marimo-team/marimo/pull/4206
* mep/8: frontend function hints by dmadisetti in https://github.com/marimo-team/marimo/pull/4025
* fix: auth page redirect when base-url is present, security headers by mscolnick in https://github.com/marimo-team/marimo/pull/4232
* fix: ignore keyboard events when coming from an input by mscolnick in https://github.com/marimo-team/marimo/pull/4233
* [pre-commit.ci] pre-commit autoupdate by pre-commit-ci in https://github.com/marimo-team/marimo/pull/4235
* fix: cleanup anywidget on unmount by mscolnick in https://github.com/marimo-team/marimo/pull/4236
* fix: don't round slider if not in scientific notation by mscolnick in https://github.com/marimo-team/marimo/pull/4234
* Add marimo-snippets to the docs by koaning in https://github.com/marimo-team/marimo/pull/4239
* fix: allow more decimals in the table filters by mscolnick in https://github.com/marimo-team/marimo/pull/4238
* feat: add clickhouse connect & chdb by Light2Dark in https://github.com/marimo-team/marimo/pull/4185
* chore(deps): update dependency vite to v6.2.3 [security] by renovate in https://github.com/marimo-team/marimo/pull/4246
* improvement: hide inline completion when not focused, add Esc hotkey by mscolnick in https://github.com/marimo-team/marimo/pull/4248
* improvement: LSP completion inside parens (), and Mod+Shift+Space for signature by mscolnick in https://github.com/marimo-team/marimo/pull/4250
* fix: show at most two decimal points in column summary axes by akshayka in https://github.com/marimo-team/marimo/pull/4251
* improvement: Add custom docstring-to-markdown convert for Google Docs by mscolnick in https://github.com/marimo-team/marimo/pull/4252

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

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

What's Changed

This release adds experimental language server support ([docs](https://docs.marimo.io/guides/editor_features/language_server/)), fixes a regression in which keyboard navigation would create cells, fixes a bug with parsing SQL references, and improves the legibility of table column summaries (while also making tables more compact).

* experimental: add LSP docs and pyproject.toml requirements by mscolnick in https://github.com/marimo-team/marimo/pull/4191
* fix duckdb refs with empty quotes by mscolnick in https://github.com/marimo-team/marimo/pull/4195
* feat: configurable marimo store cache by dmadisetti in https://github.com/marimo-team/marimo/pull/4147
* improve: smaller column summary charts by akshayka in https://github.com/marimo-team/marimo/pull/4198
* fix: column summary bars spacing, expand tooltips by akshayka in https://github.com/marimo-team/marimo/pull/4200
* improve: show column summary histogram axes by akshayka in https://github.com/marimo-team/marimo/pull/4208
* fix: j/k shouldn't make new cells in vim mode by akshayka in https://github.com/marimo-team/marimo/pull/4210


**Full Changelog**: https://github.com/marimo-team/marimo/compare/0.11.25...0.11.26