jupyter-to-marimo

Featured

Convert a Jupyter notebook (.ipynb) to a marimo notebook (.py).

AI & Automation 957 stars 79 forks Updated today MIT

Install

View on GitHub

Quality Score: 93/100

Stars 20%
99
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Converting Jupyter Notebooks to Marimo ## Convert first **Important:** Run the converter before you read the source notebook: ```bash uvx marimo convert <notebook.ipynb> -o <notebook.py> ``` Read the `.ipynb` file only if conversion fails or the generated file omits required information. Treat the generated file as a first draft. Run this command after conversion and after substantial edits: ```bash uvx marimo check <notebook.py> ``` ## Review the conversion - Verify all required packages in the PEP 723 metadata. The converter can miss some package-installation forms. - Remove residual installation cells and stale installation prose. Add version constraints only when required. - Use `--sandbox` when a notebook uses PEP 723 metadata. - Preserve the purpose and intended workflow of the source notebook. - Arrange cells for presentation. marimo determines execution order from variable definitions and references. - A cell can appear before a cell that defines its input. - Merge or split cells when the current boundaries reduce clarity. - Remove redundant Jupyter artifacts, such as unnecessary `display()` calls. - Review converted magic commands. Keep valid conversions, and resolve comments that report unsupported magics. - Put the value to render in the final expression of each cell. - Keep added UI and helper functions proportional to the notebook purpose. - Replace interactive input methods that wait for terminal input or do not work in the target interface. Use suitab...

Details

Author
autonomous-ai
Repository
autonomous-ai/openharness
Created
1 months ago
Last Updated
today
Language
C
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category