Skip to content

docs: update molab docs with new compute and sharing features#9748

Merged
akshayka merged 2 commits into
mainfrom
aka/update-molab-docs
Jun 2, 2026
Merged

docs: update molab docs with new compute and sharing features#9748
akshayka merged 2 commits into
mainfrom
aka/update-molab-docs

Conversation

@akshayka
Copy link
Copy Markdown
Contributor

@akshayka akshayka commented Jun 1, 2026

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.

Copilot AI review requested due to automatic review settings June 1, 2026 23:51
@akshayka akshayka added the documentation Improvements or additions to documentation label Jun 1, 2026
@vercel
Copy link
Copy Markdown

vercel Bot commented Jun 1, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
marimo-docs Ready Ready Preview, Comment Jun 2, 2026 12:00am

Request Review

Copy link
Copy Markdown
Contributor

@cubic-dev-ai cubic-dev-ai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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
Loading

Re-trigger cubic

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.md with 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.

Comment thread docs/guides/wasm.md
Comment thread docs/guides/publishing/index.md
Comment thread docs/guides/publishing/github.md
Comment thread docs/guides/publishing/github.md
Comment thread docs/guides/publishing/github.md
Comment thread docs/guides/molab.md
Comment thread docs/guides/molab.md
Copy link
Copy Markdown
Contributor

@cubic-dev-ai cubic-dev-ai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

Comment thread docs/guides/molab.md
Comment on lines +83 to +84
can be previewed statically, run on an ephemeral server, or run in the browser
(and embedded in web pages) with WebAssembly.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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>
Suggested change
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).

@akshayka akshayka merged commit 7b93458 into main Jun 2, 2026
30 checks passed
@akshayka akshayka deleted the aka/update-molab-docs branch June 2, 2026 02:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants