Skip to content

Convert Weave cookbooks from Colab to marimo#2407

Draft
johndmulhausen wants to merge 6 commits intomainfrom
marimo-cookibooks
Draft

Convert Weave cookbooks from Colab to marimo#2407
johndmulhausen wants to merge 6 commits intomainfrom
marimo-cookibooks

Conversation

@johndmulhausen
Copy link
Copy Markdown
Contributor

Summary

This PR updates the English Weave cookbook docs to use marimo instead of Colab or Jupyter notebooks, adds molab and marimo.app embeds, and surfaces exported notebook content as readable markdown below the embed.

What changed

  • Cookbook pages (weave/cookbooks/*.mdx): Wide layout, MolabLink with embed for the full block (Try in marimo heading, New badge, Run in molab button, WASM iframe). ExportedNotebook imports generated markdown from marimo export md under weave/cookbooks/generated/.
  • MolabLink (snippets/en/_includes/molab-link.mdx): Marimo icon, neutral chip styling, optional embed mode that derives the iframe URL from the molab GitHub URL. Non-cookbook pages (quickstart, tutorials, and others) keep using MolabLink without embed.
  • Styles (snippets/button-links.css): Molab link appearance, prose overrides, cookbook heading and badge positioning.
  • Export script (scripts/export-marimo-cookbook-md.sh): Regenerate weave/cookbooks/generated/*.mdx from source .py notebooks with MDX-safe post-processing.
  • Assets: Local marimo icon SVG (images/marimo-icon.svg).
  • Links: GitHub and molab URLs updated to the correct repo paths and branch where applicable.

Notes

  • Japanese and Korean localized cookbook paths were reverted to avoid mixing localized content with this English-focused change; follow-up can align locales separately.
  • mint broken-links may still report relative image paths inside some exported notebook markdown until notebook sources or paths are updated.

How to test

  • mint dev and spot-check a few cookbook pages.
  • ./scripts/export-marimo-cookbook-md.sh after editing a .py notebook in weave/cookbooks/source/.

Made with Cursor

… source links

- Replaced Google Colab links with an embedded Marimo iframe for running notebooks directly.
- Updated GitHub source links to point to the new Python files for each cookbook.

This change enhances user experience by providing a more integrated way to run notebooks and access source code.
…ect repository path

- Updated all relevant notebooks to replace incorrect GitHub source links with the correct path, ensuring users can access the intended Python files.
- This change improves the accuracy of documentation and enhances user experience when navigating source code.
… enhancing integration with Marimo. Update CSS for new Molab link styles and ensure consistent user experience across documentation.
Extend MolabLink with an optional embed flag that renders the Try in marimo
heading, New badge, Run in molab control, and marimo.app iframe derived from
the molab URL. Simplify English weave cookbook pages to a single MolabLink
line plus exported notebook markdown.

Made-with: Cursor
@johndmulhausen johndmulhausen requested a review from a team as a code owner April 1, 2026 05:25
@mintlify
Copy link
Copy Markdown
Contributor

mintlify bot commented Apr 1, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
wandb 🟢 Ready View Preview Apr 1, 2026, 5:29 AM

@johndmulhausen johndmulhausen changed the title Weave cookbooks: Marimo (molab) embeds, exported notebook markdown, MolabLink Convert Weave cookbooks from Colab to marimo Apr 1, 2026
@johndmulhausen johndmulhausen marked this pull request as draft April 1, 2026 05:26
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 1, 2026

📚 Mintlify Preview Links

🔗 View Full Preview

✨ Added (22 total)

📄 Pages (21)

File Preview
snippets/en/_includes/molab-link.mdx Molab Link
weave/cookbooks/generated/Intro_to_Weave_Hello_Eval.mdx Intro To Weave Hello Eval
weave/cookbooks/generated/Intro_to_Weave_Hello_Trace.mdx Intro To Weave Hello Trace
weave/cookbooks/generated/Models_and_Weave_Integration_Demo.mdx Models And Weave Integration Demo
weave/cookbooks/generated/README.md README
weave/cookbooks/generated/audio_with_weave.mdx Audio With Weave
weave/cookbooks/generated/chain_of_density.mdx Chain Of Density
weave/cookbooks/generated/codegen.mdx Codegen
weave/cookbooks/generated/custom_model_cost.mdx Custom Model Cost
weave/cookbooks/generated/dspy_prompt_optimization.mdx Dspy Prompt Optimization
... and 11 more files

🖼️ Images (1)

File Preview
images/marimo-icon.svg View Marimo Icon

📝 Changed (26 total)

📄 Pages (25)

File Preview
weave/cookbooks/Intro_to_Weave_Hello_Eval.mdx Intro To Weave Hello Eval
weave/cookbooks/Intro_to_Weave_Hello_Trace.mdx Intro To Weave Hello Trace
weave/cookbooks/Models_and_Weave_Integration_Demo.mdx Models And Weave Integration Demo
weave/cookbooks/audio_with_weave.mdx Audio With Weave
weave/cookbooks/chain_of_density.mdx Chain Of Density
weave/cookbooks/codegen.mdx Codegen
weave/cookbooks/custom_model_cost.mdx Custom Model Cost
weave/cookbooks/dspy_prompt_optimization.mdx Dspy Prompt Optimization
weave/cookbooks/feedback_prod.mdx Feedback Prod
weave/cookbooks/hf_dataset_evals.mdx Hf Dataset Evals
... and 15 more files
⚙️ Other (1)
File
snippets/button-links.css

🤖 Generated automatically when Mintlify deployment succeeds
📍 Deployment: ff28eac at 2026-04-01 05:29:36 UTC

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 1, 2026

🔗 Link Checker Results

⚠️ Some issues were detected

Checked against: https://wb-21fd5541-marimo-cookibooks.mintlify.app


Summary

Status Count
🔍 Total 164
✅ Successful 32
⏳ Timeouts 0
🔀 Redirected 17
👻 Excluded 109
❓ Unknown 0
🚫 Errors 6
⛔ Unsupported 0

Errors per input

Errors in weave/cookbooks/generated/ocr-pipeline.mdx

Errors in weave/cookbooks/generated/online_monitoring.mdx

Errors in weave/cookbooks/generated/weave_via_service_api.mdx

Full Github Actions output

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant