Marimo

What's Changed

New Features!
- 🤖 **AI Suggestions**: Bring your own OpenAI API key to unlock AI-powered suggestions!

<img width="857" alt="image" src="https://github.com/marimo-team/marimo/assets/1994308/06c5be42-33f8-4277-99a9-abeb1c3c7401">

Get started by updating your `~/.marimo.toml` config file:

toml
[ai.open_ai]
Get your API key from https://platform.openai.com/account/api-keys
api_key = "sk-..."
Choose a model, we recommend "gpt-3.5-turbo"
model = "gpt-3.5-turbo"
Change the base_url if you are using a different OpenAI-compatible API
base_url = "https://api.openai.com"


[Read the docs](https://docs.marimo.io/guides/ai_completion.html#using-ai-to-modify-cells) to learn more.

**Lazy evaluation/rendering of components** The new library function [`mo.lazy()`](https://docs.marimo.io/api/layouts/lazy.html#marimo.lazy) lets you defer the computation and rendering of components, especially useful if you have expensive components that are hidden by default (e.g., in a tab or accordion).

All changes

* chore(deps): update dependency typescript to ^5.4.3 by renovate in https://github.com/marimo-team/marimo/pull/1044
* fix(deps): update dependency react-resizable-panels to v2.0.16 by renovate in https://github.com/marimo-team/marimo/pull/1042
* chore(deps): update all eslint dependencies by renovate in https://github.com/marimo-team/marimo/pull/1043
* fix: pyodide additional remounting by mscolnick in https://github.com/marimo-team/marimo/pull/1046
* fix: dont allow renaming to '.' or '..', show dotfiles by mscolnick in https://github.com/marimo-team/marimo/pull/1047
* fix: allow removing Grid layout by mscolnick in https://github.com/marimo-team/marimo/pull/1048
* improvement: click hourglass to move view to current cell by fuenfundachtzig in https://github.com/marimo-team/marimo/pull/1040
* feat: model/base-url settings for AI completion, bring out of experimental by mscolnick in https://github.com/marimo-team/marimo/pull/1049
* feat: editor placeholder for AI prompt by mscolnick in https://github.com/marimo-team/marimo/pull/1057
* feat: mo.lazy by mscolnick in https://github.com/marimo-team/marimo/pull/1052
* fix: guard against modules that don't have a `__spec__` attr by akshayka in https://github.com/marimo-team/marimo/pull/1058
* fix: set event loop policy in create_asgi_app by akshayka in https://github.com/marimo-team/marimo/pull/1060
* chore(deps): update dependency vite to v5.1.7 [security] by renovate in https://github.com/marimo-team/marimo/pull/1054
* fix: resuming when auto-instantiate is false by akshayka in https://github.com/marimo-team/marimo/pull/1061
* improvement: update ai system prompt to be mpl aware by akshayka in https://github.com/marimo-team/marimo/pull/1062
* 0.3.9 by akshayka in https://github.com/marimo-team/marimo/pull/1063


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

What's Changed

Thanks riyavsinha and fuenfundachtzig for your contributions -- welcome to the marimo family!!

**Highlights.**

- 📦 Pixi support! This release adds support for installing packages using the Pixi package manager.
- 🌐 Query parameters! Use `mo.query_params()` to access the URL query parameters; this makes it possible to parametrize notebooks when sharing.
- ⌨ Improved keyboard navigation! Open the cell menu with `Cmd/Ctrl+p` -- no mouse clicks required -- and use `Cmd/Ctrl+Shift+m` to toggle markdown view on and off.

**All changes.**

* fix: one source of truth for language adapter state by mscolnick in https://github.com/marimo-team/marimo/pull/1027
* feat: allow deleting file from the file explorer by mscolnick in https://github.com/marimo-team/marimo/pull/1023
* feat: add config actions to Command Pallete by mscolnick in https://github.com/marimo-team/marimo/pull/1028
* fix: stale editor view in cell action buttons by akshayka in https://github.com/marimo-team/marimo/pull/1029
* feat: enable toggling to md mode automatically via mod-shift-m by riyavsinha in https://github.com/marimo-team/marimo/pull/1021
* fix: command palette shouldn't show NOOP-ed hotkeys by akshayka in https://github.com/marimo-team/marimo/pull/1032
* feat: mo.query_params by mscolnick in https://github.com/marimo-team/marimo/pull/1006
* avoid server error when encountering broken symlinks by fuenfundachtzig in https://github.com/marimo-team/marimo/pull/1034
* feat: add pixi package manager by akshayka in https://github.com/marimo-team/marimo/pull/1035
* 0.3.8 by akshayka in https://github.com/marimo-team/marimo/pull/1036

New Contributors
* riyavsinha made their first contribution in https://github.com/marimo-team/marimo/pull/1021
* fuenfundachtzig made their first contribution in https://github.com/marimo-team/marimo/pull/1034

**Full Changelog**: https://github.com/marimo-team/marimo/compare/0.3.7...0.3.8

What's Changed
* fix local file reading for mo.audio by akshayka in https://github.com/marimo-team/marimo/pull/1020
* improvement: Cmd+p to open cell actions , restore focus back to cell by mscolnick in https://github.com/marimo-team/marimo/pull/1024
* feat: support media in file viewer, allow editing files by mscolnick in https://github.com/marimo-team/marimo/pull/1022
* Remove accidental change to intro.py ... by akshayka in https://github.com/marimo-team/marimo/pull/1025
* 0.3.7 by akshayka in https://github.com/marimo-team/marimo/pull/1026


**Full Changelog**: https://github.com/marimo-team/marimo/compare/0.3.6...0.3.7

What's Changed
* improvement: update hash in url when running in wasm by mscolnick in https://github.com/marimo-team/marimo/pull/1008
* fix: don't crash kernel when package managers are missing by akshayka in https://github.com/marimo-team/marimo/pull/1009
* fix: package versions in envinfo by akshayka in https://github.com/marimo-team/marimo/pull/1010
* improvement: add poetry as a package manager by akshayka in https://github.com/marimo-team/marimo/pull/1011
* dont lock gh prs after merge by akshayka in https://github.com/marimo-team/marimo/pull/1015
* fix: more defensive restart in wasm by mscolnick in https://github.com/marimo-team/marimo/pull/1018
* send delete cell network request in cell action button by akshayka in https://github.com/marimo-team/marimo/pull/1017
* 0.3.6 by akshayka in https://github.com/marimo-team/marimo/pull/1019


**Full Changelog**: https://github.com/marimo-team/marimo/compare/0.3.5...0.3.6

What's Changed

This release includes contributions from several contributors -- thanks wasimsandhu , dmadisetti , and deepyaman!

**Highlights.** This release includes a new public API for programmatically running multiple apps (in `run`/read-only mode) -- this lets you create multi-page apps out of marimo notebooks, as well as seamlessly serve marimo apps as part of, eg, a larger FastAPI app.

Docs: https://docs.marimo.io/guides/deploying/programmatically.html

Example:

python
from typing import Annotated, Callable, Coroutine
from fastapi.responses import HTMLResponse, RedirectResponse
import marimo
from fastapi import FastAPI, Form, Request, Response


Create a marimo asgi app
server = (
marimo.create_asgi_app()
.with_app(path="", root="./pages/index.py")
.with_app(path="/dashboard", root="./pages/dashboard.py")
.with_app(path="/sales", root="./pages/sales.py")
)

Create a FastAPI app
app = FastAPI()

app.add_middleware(auth_middleware)
app.add_route("/login", my_login_route, methods=["POST"])

app.mount("/", server.build())

Run the server
if __name__ == "__main__":
import uvicorn

uvicorn.run(app, host="localhost", port=8000)


**All changes.**

* Deduplicate code completion form description field by deepyaman in https://github.com/marimo-team/marimo/pull/991
* feat: Limit maximum selections in mo.ui.multiselect by wasimsandhu in https://github.com/marimo-team/marimo/pull/996
* bug fix: support env / status without pip (992) by dmadisetti in https://github.com/marimo-team/marimo/pull/999
* fix(deps): update dependency katex to v0.16.10 [security] by renovate in https://github.com/marimo-team/marimo/pull/1000
* improvement: use url hash instead of query param by mscolnick in https://github.com/marimo-team/marimo/pull/1001
* feat: create_asgi_app to programatically run marimo apps by mscolnick in https://github.com/marimo-team/marimo/pull/1002
* 0.3.5 by akshayka in https://github.com/marimo-team/marimo/pull/1007

New Contributors
* deepyaman made their first contribution in https://github.com/marimo-team/marimo/pull/991
* wasimsandhu made their first contribution in https://github.com/marimo-team/marimo/pull/996

**Full Changelog**: https://github.com/marimo-team/marimo/compare/0.3.4...0.3.5

What's Changed

Highlights

**Automatic package discovery and installation.** marimo now automatically detects when you're missing packages in your Python environment, and gives you the option to install them using `pip`, `uv`, or `rye`. When installation is successful, cells depending on the packages are automatically re-run!

marimo will alert you to missing packages:


and keeps you updated on installation progress:


This feature makes it really easy to get started with new notebooks and projects, especially when working in a fresh Python environment: just install packages as you go!

**Visualize arrays and matrices with `mo.image()`!** `mo.image()` can now visualize NumPy arrays, torch Tensors, and Scipy sparse matrices as images.



* fix: try to load worker from file, and fallback to inline by mscolnick in https://github.com/marimo-team/marimo/pull/959
* fix: load worker from url again by mscolnick in https://github.com/marimo-team/marimo/pull/960
* fix: update user config in wasm to fallback to config from html by mscolnick in https://github.com/marimo-team/marimo/pull/967
* mo.image(): visualize NumPy array, torch.tensor, scipy.sparse matrix by dmadisetti in https://github.com/marimo-team/marimo/pull/964
* [Snyk] Upgrade copilot-node-server from 1.19.2 to 1.20.1 by mscolnick in https://github.com/marimo-team/marimo/pull/963
* feat: package installation from pypi by akshayka in https://github.com/marimo-team/marimo/pull/961
* improvment: consistent error toasting on all request by mscolnick in https://github.com/marimo-team/marimo/pull/969
* feat: configurable package manager + uv, rye support by akshayka in https://github.com/marimo-team/marimo/pull/971
* fix: graceful shutdown for uvicorn==0.29.0 by akshayka in https://github.com/marimo-team/marimo/pull/972
* improvements for running as a script by akshayka in https://github.com/marimo-team/marimo/pull/973
* faq: document how to make marimo accessible on all network interfaces by akshayka in https://github.com/marimo-team/marimo/pull/980
* Fix mpl interactive: remove asyncio.run() by akshayka in https://github.com/marimo-team/marimo/pull/981
* tests: add data-testids to components by mscolnick in https://github.com/marimo-team/marimo/pull/983
* feat: cell actions in the command-pallete by mscolnick in https://github.com/marimo-team/marimo/pull/984
* improvement: configure package manager in the missing package alert by akshayka in https://github.com/marimo-team/marimo/pull/985
* 0.3.4 by akshayka in https://github.com/marimo-team/marimo/pull/986

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

**Full Changelog**: https://github.com/marimo-team/marimo/compare/0.3.3...0.3.4