Skip to content

Releases: marimo-team/marimo

0.19.11

12 Feb 18:39
@mscolnick mscolnick
0.19.11
fea2797

Choose a tag to compare

View all tags
0.19.11 Latest
Latest

What's Changed

New Contributors

Full Changelog: 0.19.10...0.19.11

Contributors

gvwilson, nojaf, and 3 other contributors
Assets 2
Loading

0.19.10

11 Feb 20:58
@manzt manzt
0.19.10
56de1ae

Choose a tag to compare

View all tags
0.19.10

This release focuses on anywidget improvements, along with UI enhancements and many bug fixes.

⭐️ Highlights

anywidget improvements

This release improve marimo's anywidget integration with better lifecycle management, performance, and static export support (#8244, #8166, #8163, #8256, #8168, #8159, #8082). Anywidgets now render in static HTML exports with client-side interactivity preserved, and mo.state setters work in widget callbacks.

Together these changes improve performance and reliability for interactive widget libraries. Here's 10M points rendered interactively on a 24GB M4 MacBook Air with jupyter-scatter:

Try it for yourself on molab!

Column header alignment in tables

Column headers now follow the same alignment as cell data when using text_justify_columns, fixing the visual mismatch where headers stayed left-aligned while data was right- or center-aligned. (#8236)

Hide reusable functions from the dependency graph

A new "Hide reusable functions" toggle in the dependency graph settings panel lets you declutter the graph by hiding def cells that don't have edges to other cells. (#8228)

✨ Enhancements

  • Allow mo.state setters in widget callbacks (#8244)
  • Persist anywidget model state in static HTML exports (#8166)
  • Add toggle to hide reusable functions from dependency graph (#8228)
  • Always show default value for CLI args (hide if default is None) (#8246)
  • Add disabled parameter to mo.ui.chat (#8214)
  • Align column headers with text_justify_columns setting (#8236)
  • Support for dict(ChatMessage(...)) (#8091)
  • Add uv version to marimo env output (#8157)
  • Merge model messages into a single replay snapshot (#8163)

🐛 Bug fixes

  • Grab module css from model-state instead of passing via DOM attributes (#8256)
  • Remove openai from required dependencies (#8265)
  • Add back margin for missing gap in file explorer panel (#8267)
  • Batch anywidget model updates like UI element updates (#8168)
  • Better datastructures for kernel Runner (#8251)
  • Don't read the full file for OSFileSystem._is_marimo_file (#8253)
  • Prevent sidebar resize handle from overlapping file explorer buttons (#8181)
  • Normalize Html subclasses in as_html for correct f-string formatting (#8223)
  • Use variable name as download filename in dataframe viewer (#8227)
  • Avoid unnecessary duckdb calls in stats and getting db names (#8250)
  • Use mount_config.code and filename as fallback in WASM mode (#8161)
  • Continue on thumbnail capture timeout (#8254)
  • Include xfailed and xpassed in pytest summary counts (#8220)
  • Preserve justify on nested stacks when widths/heights are set (#8219)
  • Suppress RuntimeWarning for all-NaN DataFrame columns (#8217)
  • Allow interaction with sidebar behind package alert popup (#8216)
  • Prevent margin collapse between consecutive cell outputs (#8215)
  • Don't enable reactive tests in run mode (#8252)
  • Upgrade codemirror-languageserver to fix prefix completions with underscore (#8245)
  • Handle null registration.active in service worker registration (#8213)
  • Set data-theme attribute on body for third-party dark mode compat (#8231)
  • Decorator invalidation for caching (#8171)
  • Disable panel resize handles when panels are collapsed (#8183)
  • Preserve return statements inside nested functions when pasting (#8222)
  • Close anywidget comms on cell re-execution and deletion (#8159)

📚 Documentation

  • Fix reddit links (#8266)
  • Gallery + OpenGraph preview docs (#8122)
  • Removes ploomber deployment (#8249)

📝 Other changes

  • Preserve function return type in live docs panel (#8210) (#8263) (3828e5f)
  • Bump loro (#8264)
  • Update Plotly to 3.3.1 and add heatmap click event (#8255)
  • Update dependency anywidget to ~=0.9.21 (#8082)
  • Enable reading session cache in App Mode (configurable) (#7895) (d85e9b7)
  • Update codemirror dependencies (#8170)
  • Replace react-plotly.js with vendored Plot component (#8238)
  • Respect display.dataframes config setting (#8053) (190ca31)

Contributors

Thanks to all our community and contributors who made this release possible: @AhmadYasser1, @akshayka, @dmadisetti, @ffmiruz, @julianpistorius, @koaning, @Light2Dark, @manzt, @maxkoretskyi, @mscolnick, @nojaf, @peter-gy

And especially to our new contributors:

Full Changelog: 0.19.9...0.19.10

Contributors

chrisflath, julianpistorius, and 12 other contributors
Loading

0.19.9

06 Feb 21:32
@mscolnick mscolnick
0.19.9
a821edf

Choose a tag to compare

View all tags
0.19.9

What's Changed

New Contributors

Full Changelog: 0.19.8...0.19.9

Contributors

akshayka, dmadisetti, and 4 other contributors
Loading

0.19.8

05 Feb 22:06
@manzt manzt
0.19.8
0a509ee

Choose a tag to compare

View all tags
0.19.8

This release introduces notebook galleries with OpenGraph previews, along with anywidget improvements, AI enhancements, and many bug fixes.

⭐️ Highlights

Serve a gallery of notebooks

You can now serve multiple marimo notebooks as a gallery using marimo run with folders or multiple files. This is useful for showcasing collections of notebooks, tutorials, or dashboards in a single browsable interface.

# Serve all notebooks in a folder
marimo run my_notebooks/

# Serve multiple folders and files
marimo run tutorials/ examples/ standalone.py

# Run with sandboxed environments per notebook
marimo run my_notebooks/ --sandbox

Rich gallery previews with OpenGraph metadata

Gallery cards can be customized with OpenGraph metadata. Define metadata in your notebook's PEP 723 script block to control how each notebook appears in the gallery:

[tool.marimo.opengraph]
title = "My Analysis"
description = "Exploratory data analysis of Q4 results"
image = "https://example.com/thumbnail.png"

For dynamic metadata, define a generator function that computes OpenGraph fields at runtime.

You can also auto-generate thumbnail images for your notebooks using marimo export thumbnail:

# Generate thumbnails (code-only, no execution)
marimo export thumbnail my_notebooks/

# Generate thumbnails with notebook execution for richer previews
marimo export thumbnail my_notebooks/ --execute --sandbox

Thumbnails are stored in the __marimo__/ directory alongside your notebooks and served automatically in gallery mode.

Attach images to "Generate with AI"

You can now attach images when using "Generate with AI" to provide visual context for code generation. This is useful for sharing mockups, charts, or screenshots that help the AI understand what you're trying to build.

✨ Enhancements

  • Add attachments for 'Generate with AI' & ensure UI consistency (#7996)
  • Update models.yml for Opus 4.6 (#8142)
  • Add proxy_path support for ClickHouse Connections (#8128)
  • Require playwright installation for pdf export (#8121)
  • Improve design of chat mode selector (#8114)
  • Set markdown to hide after conversion for consistency (#8117)
  • Anywidget dynamic imports in static notebooks (#8110)
  • Rich notebook previews through OpenGraph metadata (#8097)
  • Graduate performant table charts and chat modes from experimental (#8107)
  • Sandboxed gallery (#8076)
  • Replace logo with back button for notebooks in gallery mode (#8099)
  • Register Office document mimetypes for cross-platform compatibility (#8068)
  • Support serving a gallery of notebooks (#8056)

🐛 Bug fixes

  • Fix spurious "truth value of UIElement" warning for anywidgets (#8148)
  • Decouple anywidget model and view (#8124)
  • Support pandas 3.0 str col (#8146)
  • Follow ruff rules for formatting trailing space after imports/ functions (#8086)
  • Search functionality for DataFrames with index columns (#8136)
  • Support multiple vfile registries with shared inmemorystorage (#8145)
  • Don't error when writing UI elements values that already exist (#8147)
  • Avoid unnecessary throwing error in delete cell (#8134)
  • Remove some deprecation warnings (#8113)
  • Handle bang statement edgecases in ipynb convert (#8126)
  • Top-level defs showing up in wasm (#8138)
  • Use cell name to identify setup cells when id is null (#8137)
  • Hash on unspecified keyword values (#8127)
  • Handle marimo tex components when exporting to PDF (#8062)
  • Sandbox package listing (#8104)
  • Preserve whitespaces & new lines when inferring parts during rendering outputs (#8116)
  • Don't allow '.' when creating custom provider names (#8115)
  • Fix schema drift for chat-ui (ai-sdk 6) (#8105)
  • Handle objects with __getattr__ returning non-callable values in serialization (#8109)
  • Gracefully handle timeouts/input from uv when adding script metadata (#8111)
  • Add missing word to UI tutorial (#8087)
  • Handle sqlglot OptimizeError for DuckDB unnest with JSON access (#8083)
  • Enable weave tracing on chat widget (#8078)
  • Table data not refreshing after mo.output.replace() when first-page data is unchanged (#8066)

📚 Documentation

  • Clarify markdown section in Jupyter users tutorial (#8092)

📝 Other changes

  • Update all biome dependencies to v2.3.13 (#8044)
  • Upgrade pytest plugins, upperbound sqlglot (#8077)
  • Update WebSocket URL generation for agents to work on remote deployments (#8065)
  • Update all npm non-major dependencies (#8085)
  • Add missing type field to control requests (#8071)

Contributors

Thanks to all our community and contributors who made this release possible: @dmadisetti, @gvwilson, @koaning, @Light2Dark, @lucharo, @manzt, @maruthgoyal, @mscolnick, @peter-gy, @marcodlk

New Contributors

Full Changelog: 0.19.7...0.19.8

Contributors

gvwilson, koaning, and 10 other contributors
Loading

0.19.7

29 Jan 19:14
@mscolnick mscolnick
0.19.7
fc88208

Choose a tag to compare

View all tags
0.19.7

⭐️ Highlights

PDF Export

marimo now supports exporting notebooks as PDFs, both from the CLI and directly from the notebook interface. Whether you're generating documentation, creating reports, or sharing your work, you can now produce professional-looking PDF outputs with full support for your notebook's visualizations and markdown content.

Export from the command line using the new marimo export pdf command, with options to control output format and include CLI arguments for parameterized notebooks. The PDF exporter runs your notebook, captures all outputs, and uses nbconvert's WebPDF exporter (powered by Chromium) for high-quality rendering. When running marimo as a notebook, you'll find a new "Export as PDF" option in the export menu.

# Export a notebook to PDF
marimo export pdf notebook.py -o notebook.pdf

# Pass CLI arguments to your notebook
marimo export pdf notebook.py -o report.pdf -- --date 2026-01-29 --region west

# Watch for changes and auto-regenerate
marimo export pdf notebook.py -o notebook.pdf --watch

Requirements: PDF export requires nbformat and nbconvert[webpdf] to be installed.

✨ Enhancements

  • apply patch for extraStyleContent (#8043)
  • add more linking to provider page (#8041)
  • Lsp status icon and refresh (#8011)
  • Additional print configuration, fix race conditions in export to pdf (#8038)
  • Include mime-type precedence and visibilty rules (#8037)
  • add snappy parameter to speed up auto-export (#8032)
  • fix carousel styles (#8022)
  • add progress bar for download pdf (#8016)
  • add placeholder images for external iframes on export to pdf (#8003)
  • Support srcdoc screenshots (#8001)
  • link to provider and model page directly (#7979)
  • Dont set --compile-bytecode for uv installation (#7985)
  • Add Minimap/Graph toggle to dependencies panel in developer panel (#7976)
  • Downgrade dataframe in non-interactive environments (#7940)

🐛 Bug fixes

  • No diff churn when adding requires-python to a sandboxed file (#8054)
  • Add back LSP snippets, upgrade codemirror-languageserver (#8052)
  • LSP reconfiguration missing cell-id (#8050)
  • remove manual handling of local iframes, only external iframes (#8051)
  • Ensure overflow is captured in screenshots, and ensure smooth capture (#8046)
  • fix timing issue to apply edits after data has come in (#8025)
  • Lsp potential race conditions (#8012)
  • Save content when creating a new file via filename input (#8009)
  • Ensure logs are scrollable in developer panel (#8002)
  • Refine rendering of equations in chat pane (#7961)
  • Add plotly scattermap/scattermapbox point selection support (#7975)
  • prevent layout shift for auto-export ipynb (#7965)
  • Avoid ValueError when comparing embed defs with NumPy arrays (#7980)
  • fix setting UI config to empty for AI custom & displayed models (#7991)
  • Plotly shapes not clearing when removed from figure (#7974)
  • Correct input channel direction for IPC sandbox mode (#7973)
  • support ansi characters in pdf export (#7962)

📚 Documentation

  • Small textual corrections in Claude Code doc (#7951)

🔬 Preview features

  • turn on server_side_export_to_pdf flag (#8036)

📝 Other changes

  • 0.19.7 (fc88208)
  • Default to wedpdf since tex seems to have more issues (#8055)
  • Proper fallback for mo.watch.file in wasm (#7982)
  • toast an error if Export as png fails (#8049)
  • Preserve _marimo_row_id when clamping table columns (#8029) (#8035) (83f0901)
  • Update all biome dependencies to v2.3.12 (#8039)
  • Update pymdownx admonition smoke tests with new syntax (#8028)
  • Consolidate watch_and_export implementations (#8000)
  • Export notebooks as PDFs via CLI (#7997)
  • Windows path issue (#7978) (#7990) (6d3a6eb)
  • Update all storybook dependencies to ^10.2.0 (#7987)

Contributors

Thanks to all our community and contributors who made this release possible: @akshayka, @app/renovate, @dmadisetti, @faysou, @Light2Dark, @manzt, @mscolnick, @MukeshK17, @peter-gy, @sswatson-ap

New Contributors

Full Changelog: 0.19.6...0.19.7

Contributors

faysou, akshayka, and 8 other contributors
Loading

0.19.6

24 Jan 00:15
@akshayka akshayka
0.19.6
62cd22c

Choose a tag to compare

View all tags
0.19.6

What's Changed

🐛 Bug fixes

  • fix number component navigation (#7957)
  • --sandbox flag should add script metadata when none exists (#7954)
  • Include rich console outputs in PDF/ipynb export (#7955)

📚 Documentation

  • Add screenshot and clarify ipynb snapshotting docs (#7952)

📝 Other changes

  • 0.19.6 (62cd22c)
  • Update react-aria dependencies (#7822)
  • Update dependency vite to v7.3.1 (#7946)

Contributors

Thanks to all our community and contributors who made this release possible: @akshayka, @app/renovate, @manzt, @mscolnick

Full Changelog: 0.19.5...TODO_CURRENT_VERSION

Contributors

akshayka, mscolnick, and manzt
Loading

0.19.5

22 Jan 22:53
@mscolnick mscolnick
0.19.5
52f229f

Choose a tag to compare

View all tags
0.19.5

What's Changed

✨ Enhancements

  • inverted flag for pdfDownloadEnabled (#7936)
  • smartly set chat & edit models based on ai config (#7901)
  • CLI update secure docker to python3.14 (#7926)
  • Fallback to png for matplotlib when in a non-interactive environment (#7924)
  • Add config for default csv encoding (#7875)
  • Fail CLI edit if shared memory is not available (#7921)
  • Move marimo import to top in convert command (#7828)
  • add new endpoint to download pdf using nbconvert & feature flag (#7894)
  • Use vega 6 mimetype, capture screenshots on pdf export (#7906)
  • Export mo.mpl.interactive as PNG, and altair as json spec when running (#7874)
  • Normalize git urls in conversion from jupyter to marimo deps (#7876)
  • Include marimo metadata on ipynb export (#7878)
  • Add [marimo.server.disable_file_downloads] (#7844)
  • Add --session-ttl flag to marimo edit (#7863)

🐛 Bug fixes

  • Fixes cases where images end up clipped when taking screenshots for pdf downloads (#7933)
  • fix chat panel clipping issue (#7930)
  • Don't broadcast variables from embedded apps (#7896)
  • Serialize geopandas geometry columns as WKT strings (#7923)
  • Specify a package name to be installed by DependencyManager (#7907)
  • Dont hide cell if interactive with vim search or dropdowns (#7911)
  • Skip normalization for cloudpath (#7904)
  • Fix SQL f-string placeholder causing parsing errors in interval expressions (#7881)
  • UI element interaction should respect overridden defs in embedded apps (#7889)
  • fix run buttons being flexed in compact mode (#7885)
  • LSP diagnostics (#7877)
  • Preserve trailing comments in pure functions, setup cell (#7879)
  • Remove hover border on borderless cells (#7870)
  • Nested display math (#7873)
  • Improve error handling for pyiceberg list_namespaces permission errors (#7864)

📚 Documentation

  • Plotly express install needs dependency group (#7897)
  • Fix some embeds (#7890)
  • Update sandbox documentation link to correct page (#7888)
  • Remove opt-in note about reactive reference highlighting (#7868)

📝 Other changes

  • Pandas dataframe named index cells showing empty (#7942) (#7944) (3127f40)
  • Data-explorer charts from vega-upgrade (#7941)
  • Support base-url in LSPs (#7909)
  • Add deserialize NotebookSerializer (#7925)
  • [pre-commit.ci] pre-commit autoupdate (#7900)
  • Add documentation for sidebar and developer panel (#7758) (9bcb4ff)

Contributors

Thanks to all our community and contributors who made this release possible: @akshayka, @AnirudhDagar, @app/pre-commit-ci, @dmadisetti, @EdSwarthout, @koaning, @Light2Dark, @manzt, @mscolnick, @tokoko, @VedantMadane

New Contributors

Full Changelog: 0.19.4...0.19.5

Contributors

koaning, akshayka, and 8 other contributors
Loading

0.19.4

15 Jan 22:13
@mscolnick mscolnick
0.19.4
4844ac4

Choose a tag to compare

View all tags
0.19.4

What's Changed

Full Changelog: 0.19.3...0.19.4

Contributors

akshayka and mscolnick
Loading

0.19.3

15 Jan 20:03
@manzt manzt
0.19.3
56bd63c

Choose a tag to compare

View all tags
0.19.3

This release introduces isolated sandbox environments for multi-notebook directories and migrates our AI integrations to pydantic-ai for improved reliability with modern LLM providers.

What's Changed

Multi-Notebook Sandboxed Home

You can now run marimo edit --sandbox directory/ to open a folder of notebooks where each notebook runs in its own isolated sandbox environment. This means:

  • Every notebook automatically gets its own virtual environment with its own dependencies
  • Dependencies are managed per-notebook using PEP 723 inline script metadata
  • Each notebook remains reproducible and self-contained

This is useful when working on multiple notebooks with different dependency requirements, or for maintaining a collection of standalone, shareable notebooks.

# Open a directory with per-notebook isolation
marimo edit --sandbox ./notebooks/

Note

This feature requires pyzmq as a dependency. If you're running marimo with uvx, use:

uvx --with pyzmq marimo edit --sandbox ./notebooks/

Alternatively install marimo as marimo[sandbox] or marimo[recommended] to get all the recommended packages.

See our guide on sandboxed home and inlining dependencies guide for more details on sandboxed notebooks.

AI Provider Migration to pydantic-ai

We've migrated our AI integrations to use pydantic-ai, which brings several improvements:

  • Better model support: Fixed issues with newer OpenAI models (GPT-5, Codex models) that require the Responses API and max_completion_tokens parameter
  • Improved timeout handling: Resolved timeout issues when connecting to remote Ollama instances and other providers
  • Support for more providers: Added support for providers like Mistral that aren't fully OpenAI-compatible
  • Better error handling: More informative error messages when AI requests fail

This is a behind-the-scenes change that improves reliability—your existing AI configuration should continue to work without changes

✨ Enhancements

  • Migrate AI providers to pydantic-ai (#7732)
  • Add custom AI providers in config (#7771)
  • Support custom models returning vercel chunks (#7797)
  • Add [tool.marimo.venv].path to specify a specific venv (#7821)
  • Support images mimebundling in auto export for ipynb (#7825)
  • Allow for __contains__ and __getitem__ in anywidget (#7846)
  • Clarify column filtering is only for top 30 values (#7840)
  • Update connecting alert to show a spinner and banner notification (#7839)
  • Include errors with ipynb exports (#7811)
  • Runtime configuration tooltips, docs (#7819)
  • Parse indented code blocks (#7817)
  • Don't steal focus when embedded in an iframe (#7798)
  • Auto-close curly braces within strings (#7759)
  • When previewing ibis tables in interactive mode, also include SQL and repr tabs (#7757)
  • Sandboxed home (#7702)
  • Ensure Plotly area chart is reactive (#7761)

🐛 Bug fixes

  • Keep rich objects in chat message (#7851)
  • Ibis Deferred expression object will not be handeled as datasource (#7801)
  • Duplicate notebook when running 'marimo edit ' (#7841)
  • Fix mo.ui.dataframe showing incorrect column count (#7845)
  • Start remote connection in a Connecting state (#7838)
  • Escape key should not prevent exiting to Vim mode (#7812)
  • Keep terminal mounted to preserve session across tab switches (#7833)
  • Enhance keyboard handling in editable name cell component (#7818)
  • Fix reactive Plotly heatmap selection with datetime axes (#7805)
  • Limit private variable rename to current cell (#7814)
  • More defensive edge cases when adding packages to inline metadata (#7813)
  • Ensure repr_mimebundle handles empty include/exclude parameters gracefully (#7787)
  • Fixes chat config not updating (#7808)
  • Fix opencode duplicate tokens bug (#7792)
  • Return empty string if no tabs (#7772)
  • Setup cell (#7778)

📚 Documentation

  • Document mo.ui.plotly support for bar and heatmap (#7769)

📝 Other changes

  • Update react-aria dependencies (#7822)

Contributors

Thanks to all our community and contributors who made this release possible: @akshayka, @alonsosilvaallende, @andrewsoonqn, @AnirudhDagar, @dmadisetti, @koaning, @Light2Dark, @mscolnick, @NickCrews, @nojaf, @pepijndevos, @Ravinlathigra, @szst11

Full Changelog: 0.19.2...0.19.3

Contributors

pepijndevos, koaning, and 11 other contributors
Loading

0.19.2

11 Jan 03:24
@akshayka akshayka
0.19.2
14ee233

Choose a tag to compare

View all tags
0.19.2

What's Changed

This PR fixes a bug that prevented deployed notebooks from accessing request context like user authentication data, cookies, headers, etc.

New Contributors

Full Changelog: 0.19.1...0.19.2

Contributors

Ravinlathigra
Loading