feat: self-contained WASM export bundles for offline use by peter-gy · Pull Request #10879 · marimo-team/marimo

peter-gy · 2026-09-17T08:19:12Z

Adds --offline to bundle Pyodide and notebook dependencies alongside HTML-WASM exports:

uv run --with playwright python -m playwright install chromium

uv run --with playwright marimo export html-wasm notebook.py \
  --offline --no-sandbox -o dist

Exporting requires internet access and Playwright/Chromium. Pyodide resolves browser-compatible dependencies without executing notebook cells. The generated folder uses relative URLs and can be moved or served offline.

Runtime URL configuration remains separate from bundling, so granular source overrides can be exposed later. Existing exports retain their hosted defaults.

The export still requires a reachable HTTP server. It does not add browser offline caching, and notebook data/API calls & widget JavaScript assets need separate handling.

Closes #9811.

vercel · 2026-09-17T08:19:16Z

Deployment failed for project marimo-docs with the following error:

You don't have permission to create a Preview Deployment for this Vercel project: marimo-docs.

View Documentation: https://vercel.com/docs/accounts/team-members-and-roles

Copilot

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

github-actions · 2026-09-17T08:19:26Z

All contributors have signed the CLA ✍️ ✅
_{Posted by the CLA Assistant Lite bot.}

codecov · 2026-09-17T08:22:06Z

Bundle Report

Changes will increase total bundle size by 1.19kB (0.0%) ⬆️. This is within the configured threshold ✅

Detailed changes

Bundle name	Size	Change
marimo-esm	26.45MB	1.19kB (0.0%) ⬆️

Affected Assets, Files, and Routes:

view changes for bundle: marimo-esm

Assets Changed:

Asset Name	Size Change	Total Size	Change (%)
`assets/index-*.js`	408 bytes	1.33MB	0.03%
`assets/worker-*.js`	228 bytes	109.43kB	0.21%
`assets/save-*.js`	550 bytes	105.84kB	0.52%
`assets/__vite-*.js`	-5 bytes	93 bytes	-5.1%
`assets/__vite-*.js`	5 bytes	98 bytes	5.38% ⚠️

Files in assets/index-*.js:

./src/core/wasm/runtime-config.ts → Total Size: 527 bytes
./src/core/wasm/rpc.ts → Total Size: 398 bytes
./src/core/wasm/bridge.ts → Total Size: 13.33kB

cubic-dev-ai

1 issue found across 20 files

Prompt for AI agents (unresolved issues)


Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="marimo/_export/offline.py">

<violation number="1" location="marimo/_export/offline.py:162">
P2: When offline export runs as root or in a container, Chromium fails because `--no-sandbox` never reaches Playwright. Forward the CLI sandbox choice into `_resolve_packages` and launch Chromium with the corresponding no-sandbox option.</violation>
</file>

_{Reply with feedback, questions, or to request a fix.

Re-trigger cubic}

cubic-dev-ai · 2026-09-17T08:37:01Z

+    from playwright.async_api import async_playwright  # type: ignore[import-not-found]
+
+    async with async_playwright() as playwright:
+        browser = await playwright.chromium.launch()


P2: When offline export runs as root or in a container, Chromium fails because --no-sandbox never reaches Playwright. Forward the CLI sandbox choice into _resolve_packages and launch Chromium with the corresponding no-sandbox option.

Prompt for AI agents

Check if this issue is valid — if so, understand the root cause and fix it. At marimo/_export/offline.py, line 162: <comment>When offline export runs as root or in a container, Chromium fails because `--no-sandbox` never reaches Playwright. Forward the CLI sandbox choice into `_resolve_packages` and launch Chromium with the corresponding no-sandbox option.</comment> <file context> @@ -0,0 +1,309 @@ + from playwright.async_api import async_playwright # type: ignore[import-not-found] + + async with async_playwright() as playwright: + browser = await playwright.chromium.launch() + try: + page = await browser.new_page() </file context>

This finding looks invalid. playwright already launches chromium with --no-sandbox by default. marimo's --sandbox flag controls Python environment isolation and does not affect browser sandboxing.

mscolnick

this is a really great approach! great stuff

mscolnick · 2026-09-17T15:04:22Z

+export interface WasmRuntimeConfig {
+  pyodideIndexUrl?: string;
+  pyodideLockfileUrl?: string;
+  pypiIndexUrl?: string;


I wonder if this is how we should be sending marimo version too (not required in this PR). This is much cleaner than shoving in the worker name.

Sure, we can do that in a follow up

Pass independent Pyodide, lockfile, and package-index URLs through the export template and both workers while preserving hosted defaults.

Resolve browser-compatible packages in Pyodide through Playwright, stage downloads, and preserve prior exports with content-addressed wheels and lockfiles.

Wire runtime bundling through both export paths, preserve local wheel handling, and document the setup and local HTTP hosting requirements.

Probe the actual headless browser before downloading assets and report its setup command when startup fails.

Follow up on #10879. With this, we now pass the marimo version through `WasmRuntimeConfig` instead of encoding it in the worker name. Both WASM workers use the bootstrap config as the version source and their names remain stable while preserving the custom-controller capability suffix.

Follow-up to #10879. `--offline` can now build the bundle from internal mirrors, for networks that can't reach jsDelivr or PyPI: ```bash marimo export html-wasm notebook.py -o dist --offline \ --pyodide-index-url https://mirror.example.com/pyodide/full/ \ --pypi-index-url https://mirror.example.com/pypi/simple/ ``` A mirrored Pyodide distribution brings its own `pyodide-lock.json`, and marimo's own packages then come from the package index. Everything still resolves from the lockfile first, so Pyodide-built pins like `pydantic-core` hold with any index. The resolver fetches through Python, so mirrors need no CORS headers, and the export stops early when a mirror serves a different Pyodide version. The bundle is now the dependency closure of what the notebook needs, so a download that fails mid-export stops it instead of shipping a bundle that won't boot. Closes #10985.

Copilot AI lite review requested due to automatic review settings September 17, 2026 08:19

peter-gy requested a review from akshayka as a code owner September 17, 2026 08:19

Copilot AI reviewed Sep 17, 2026

github-actions Bot added the documentation Improvements or additions to documentation label Sep 17, 2026

peter-gy added the enhancement New feature or request label Sep 17, 2026

cubic-dev-ai Bot reviewed Sep 17, 2026

View reviewed changes

peter-gy requested a review from mscolnick September 17, 2026 08:57

mscolnick previously approved these changes Sep 17, 2026

View reviewed changes

Ryanphoenix mentioned this pull request Sep 17, 2026

Add configurable and offline html-wasm runtimes #10876

Closed

6 of 7 tasks

dmadisetti mentioned this pull request Sep 17, 2026

Automatically bundling data into WASM notebooks #5535

Open

1 task

peter-gy added 7 commits September 19, 2026 20:57

feat: configure WASM runtime and package sources

668f3c7

Pass independent Pyodide, lockfile, and package-index URLs through the export template and both workers while preserving hosted defaults.

feat: bundle Python dependencies for offline WASM exports

4db8da2

Resolve browser-compatible packages in Pyodide through Playwright, stage downloads, and preserve prior exports with content-addressed wheels and lockfiles.

feat: add --offline to html-wasm exports

a5c57dc

Wire runtime bundling through both export paths, preserve local wheel handling, and document the setup and local HTTP hosting requirements.

fix: ignore malformed WASM runtime URLs

150594b

fix: check Chromium before offline WASM export

ff559b5

Probe the actual headless browser before downloading assets and report its setup command when startup fails.

docs: clarify offline WASM export prerequisites

cf67064

fix: support older packaging in offline WASM exports

fa64758

peter-gy dismissed mscolnick’s stale review via fa64758 September 19, 2026 19:02

peter-gy force-pushed the pgy/offline-wasm-exports branch from c18e330 to fa64758 Compare September 19, 2026 19:02

peter-gy requested a review from mscolnick September 19, 2026 19:03

mscolnick approved these changes Sep 20, 2026

View reviewed changes

peter-gy merged commit eed9fb1 into marimo-team:main Sep 20, 2026
42 of 44 checks passed

peter-gy mentioned this pull request Sep 20, 2026

refactor(wasm): pass version through runtime config #10920

Merged

Ryanphoenix mentioned this pull request Sep 24, 2026

Expose Pyodide and PyPI source URLs for offline WASM exports #10985

Closed

1 task done

peter-gy mentioned this pull request Sep 29, 2026

feat: build offline WASM exports from package mirrors #11017

Merged

peter-gy mentioned this pull request Oct 5, 2026

fix(wasm): keep version specifiers when installing script dependencies #10871

Merged

Navigation Menu

Repository navigation

feat: self-contained WASM export bundles for offline use - #10879

feat: self-contained WASM export bundles for offline use#10879
peter-gy merged 7 commits into
marimo-team:mainfrom
peter-gy:pgy/offline-wasm-exports

peter-gy commented Sep 17, 2026

Uh oh!

vercel Bot commented Sep 17, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

github-actions Bot commented Sep 17, 2026

Uh oh!

codecov Bot commented Sep 17, 2026 •

edited

Loading

Assets Changed:

Uh oh!

cubic-dev-ai Bot left a comment •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

Uh oh!

cubic-dev-ai Bot Sep 17, 2026

Uh oh!

peter-gy Sep 17, 2026

Uh oh!

mscolnick left a comment

Uh oh!

mscolnick Sep 17, 2026

Uh oh!

peter-gy Sep 17, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

peter-gy commented Sep 17, 2026

Uh oh!

vercel Bot commented Sep 17, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

github-actions Bot commented Sep 17, 2026

Uh oh!

codecov Bot commented Sep 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Bundle Report

Affected Assets, Files, and Routes:

Assets Changed:

Uh oh!

cubic-dev-ai Bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

cubic-dev-ai Bot Sep 17, 2026

Choose a reason for hiding this comment

Uh oh!

peter-gy Sep 17, 2026

Choose a reason for hiding this comment

Uh oh!

mscolnick left a comment

Choose a reason for hiding this comment

Uh oh!

mscolnick Sep 17, 2026

Choose a reason for hiding this comment

Uh oh!

peter-gy Sep 17, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

codecov Bot commented Sep 17, 2026 •

edited

Loading

cubic-dev-ai Bot left a comment •

edited

Loading