docs: update molab docs with new compute and sharing features#9748
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
There was a problem hiding this comment.
No issues found across 8 files
Architecture diagram
sequenceDiagram
participant Dev as Developer
participant GitHub as GitHub Repository
participant molab as molab Platform
participant UI as molab UI (Browser)
participant Runner as Notebook Runner (Container)
participant GPU as NVIDIA RTX Pro GPU
participant AI as AI Agent / marimo pair
Note over Dev,GPU: Compute & GPU Provisioning Flow
Dev->>molab: Create/open notebook via UI
molab->>Runner: Provision container (4 CPU / 32GB RAM)
Runner-->>molab: Container ready
molab-->>UI: Notebook editor loaded
alt User toggles GPU on
UI->>molab: Request GPU attach
molab->>GPU: Attach NVIDIA RTX Pro 6000 Blackwell (96GB VRAM)
GPU-->>Runner: GPU available in container
Runner-->>UI: GPU indicator active
end
Runner->>Runner: Auto-shutdown (idle >90min) or max 12hr session
Note over Dev,AI: AI Pairing & Built-in AI Flow
Dev->>UI: Select "Pair with an agent"
UI->>Runner: Generate pair prompt
Runner-->>UI: Pair prompt with connection details
Dev->>Dev: Install marimo pair skill locally
Dev->>AI: Copy prompt to AI agent (Claude Code / Codex / OpenCode)
AI->>Runner: Connect via marimo pair (writes code, installs packages, manipulates widgets)
Runner-->>UI: Real-time collaboration canvas
alt Built-in AI assistance
Dev->>UI: Use AI refactor/generate cell
UI->>Runner: AI request (open-source model)
Runner-->>UI: Generated code
end
Note over Dev,Runner: Mirroring & Sharing Flows
Dev->>UI: New synced notebook from GitHub URL
UI->>molab: Add GitHub URL
molab->>GitHub: Fetch notebook source
GitHub-->>molab: Notebook content
molab->>UI: Synced notebook created (GitHub = source of truth)
Dev->>GitHub: Push local changes
GitHub-->>molab: Auto-reflect changes in synced notebook
alt Static preview
UI->>molab: Request preview /_static session JSON
Runner-->>UI: Rendered outputs (pre-committed)
else Interactive preview with ephemeral server
molab->>Runner: Spawn ephemeral container
Runner-->>UI: Interactive notebook
end
Dev->>UI: Share as slides or data app
UI->>Runner: Generate slides/app view
Runner-->>UI: Presentation mode
Dev->>UI: Get iframe embed snippet
UI-->>Dev: Embed code for 3rd-party pages
Note over UI,molab: Discovery & Gallery Flow
Dev->>UI: Navigate to "Discover" tab
UI->>molab: Fetch community notebooks
molab-->>UI: Curated notebook list
Dev->>UI: Tag marimo on socials
UI-->>molab: Submission to community gallery consideration
There was a problem hiding this comment.
Pull request overview
Updates the molab documentation to reflect new compute (CPU/RAM/GPU) and sharing capabilities, and adjusts related docs to align GitHub sharing guidance with the updated molab UX.
Changes:
- Expanded
molab.mdwith new sections for compute (incl. GPU), AI workflows, and updated sharing/discovery features. - Updated cross-doc links to point at the renamed “Mirror notebooks from GitHub” section.
- Tweaked embedding/sharing guidance across publishing and WASM guides to reflect the new molab flow.
Reviewed changes
Copilot reviewed 5 out of 8 changed files in this pull request and generated 7 comments.
Show a summary per file
| File | Description |
|---|---|
| docs/guides/wasm.md | Updates molab GitHub preview link target in the WASM creation/sharing section. |
| docs/guides/publishing/index.md | Updates GitHub preview link target in the publishing overview. |
| docs/guides/publishing/github.md | Updates molab guide anchor references related to GitHub previews/sharing. |
| docs/guides/publishing/embedding.md | Updates molab anchor reference for embedding from GitHub previews. |
| docs/guides/molab.md | Major refresh: compute/GPU + AI + revised GitHub mirroring and sharing sections. |
There was a problem hiding this comment.
1 issue found across 1 file (changes from recent commits).
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="docs/guides/molab.md">
<violation number="1" location="docs/guides/molab.md:83">
P3: The new synced-notebook description overstates WASM support; add a compatibility qualifier so users don’t assume all synced notebooks can run/embed in browser.</violation>
</file>
Reply with feedback, questions, or to request a fix.
Re-trigger cubic
| can be previewed statically, run on an ephemeral server, or run in the browser | ||
| (and embedded in web pages) with WebAssembly. |
There was a problem hiding this comment.
P3: The new synced-notebook description overstates WASM support; add a compatibility qualifier so users don’t assume all synced notebooks can run/embed in browser.
Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At docs/guides/molab.md, line 83:
<comment>The new synced-notebook description overstates WASM support; add a compatibility qualifier so users don’t assume all synced notebooks can run/embed in browser.</comment>
<file context>
@@ -80,7 +80,8 @@ own workspace.
"synced" notebooks use GitHub as their source of truth: develop locally, push
your changes, and see them reflected in molab automatically. Synced notebooks
-can be previewed statically or run on an ephemeral server.
+can be previewed statically, run on an ephemeral server, or run in the browser
+(and embedded in web pages) with WebAssembly.
</file context>
| can be previewed statically, run on an ephemeral server, or run in the browser | |
| (and embedded in web pages) with WebAssembly. | |
| can be previewed statically, run on an ephemeral server, or, when | |
| WebAssembly-compatible, run in the browser (and embedded in web pages). |
molab now includes more compute resources, GPU, and more sharing features. This PR updates our docs page to reflect that. It also simplifies the documentation on sharing from GitHub, since this feature is now exposed in the main molab user interface.