Project Icon

marimo

响应式Python编程环境实现自动化和一致性

marimo是一款创新的响应式Python笔记本,通过自动运行依赖单元格实现代码和输出的一致性。它提供交互式UI元素、可重现性和确定性执行顺序。笔记本以纯Python形式存储,可作为脚本执行或部署为应用。内置SQL支持、数据源面板和Git友好性等特性,为开发者提供强大而灵活的编程环境。

一个可重复、适合git版本控制、可部署为脚本或应用的响应式Python笔记本。

文档 · Discord · 示例

marimo 是一个响应式Python笔记本:运行一个单元格或与UI元素交互时,marimo会自动运行依赖的单元格(或将其标记为过时),保持代码和输出的一致性。marimo笔记本以纯Python形式存储,可作为脚本执行,并可部署为应用程序。

主要特点

  • 响应式:运行一个单元格时,marimo会自动运行所有依赖的单元格
  • 交互式:将滑块、表格、图表等绑定到Python代码 — 无需回调函数
  • 可重现:无隐藏状态,确定性执行
  • 可执行:作为Python脚本执行,可通过命令行参数进行参数化
  • 可共享:部署为交互式Web应用,或通过WASM在浏览器中运行
  • 数据中心:内置SQL支持和数据源面板
  • 适合git版本控制:以 .py 文件形式存储
pip install marimo && marimo tutorial intro

我们的在线游乐场尝试marimo,完全在浏览器中运行!

跳转到快速入门了解我们的CLI使用入门。

响应式编程环境

marimo保证您的笔记本代码、输出和程序状态保持一致。这解决了许多与传统笔记本(如Jupyter)相关的问题。

响应式编程环境。 运行一个单元格时,marimo会自动运行引用其变量的单元格,消除了手动重新运行单元格的容易出错的任务。删除一个单元格时,marimo会从程序内存中清除其变量,消除隐藏状态。

兼容计算密集型笔记本。 marimo允许您将运行时配置为惰性模式,将受影响的单元格标记为过时而不是自动运行它们。这在保证程序状态的同时,防止意外执行计算密集型单元格。

同步UI元素。 与滑块、下拉菜单和数据框转换器等UI元素交互时,使用它们的单元格会自动以最新值重新运行。

高性能运行时。 marimo通过静态分析您的代码,仅运行需要运行的单元格。

动态Markdown和SQL。 使用Markdown讲述依赖Python数据的动态故事。或构建依赖Python值的SQL查询,并使用我们内置的SQL引擎对数据框、数据库、CSV、Google表格或任何其他内容执行查询,结果以Python数据框形式返回。

即使使用Markdown或SQL,您的笔记本仍然是纯Python。

确定性执行顺序。 笔记本按照确定性顺序执行,基于变量引用而不是单元格在页面上的位置。组织您的笔记本以最适合您想讲述的故事。

功能丰富。 marimo配备了GitHub Copilot、Ruff代码格式化、HTML导出、快速代码补全、VS Code扩展、交互式数据框查看器以及许多其他便利功能。

快速入门

安装。 在终端中运行

pip install marimo  # 或 conda install -c conda-forge marimo
marimo tutorial intro

或在Gitpod中运行。

点击此链接在Gitpod工作区中打开仓库:

https://gitpod.io/#https://github.com/marimo-team/marimo

创建笔记本。

使用以下命令创建或编辑笔记本:

marimo edit

运行应用。 将您的笔记本作为Web应用运行,隐藏并禁止编辑Python代码:

marimo run your_notebook.py

作为脚本执行。 在命令行中将笔记本作为脚本执行:

python your_notebook.py

自动转换Jupyter笔记本。 使用CLI自动将Jupyter笔记本转换为marimo笔记本

marimo convert your_notebook.ipynb > your_notebook.py

或使用我们的Web界面

教程。 列出所有教程:

marimo tutorial --help

有问题?

查看我们文档中的常见问题

了解更多

marimo易于上手,同时为高级用户提供了大量功能。 例如,这里有一个用marimo制作的嵌入可视化工具 (视频):

查看我们的文档examples/文件夹和我们的画廊以了解更多信息。

贡献

我们感谢所有的贡献!您不需要成为专家就能提供帮助。 请参阅CONTRIBUTING.md以了解如何开始的更多详细信息。

有问题?请在Discord上联系我们

社区

我们正在建立一个社区。来和我们一起交流吧!

灵感 ✨

marimo是对Python笔记本的重新构想,将其打造成一个可重现、交互式和可共享的Python程序,而不是一个容易出错的JSON草稿本。

我们相信,我们使用的工具塑造了我们的思维方式——更好的工具,带来更好的思维。通过marimo,我们希望为Python社区提供一个更好的编程环境,用于进行研究并传播成果;用于试验代码并分享;用于学习和教授计算科学。

我们的灵感来自许多地方和项目,特别是Pluto.jlObservableHQBret Victor的文章。marimo是朝着反应式数据流编程这一更广泛运动的一部分。从IPyflowstreamlitTensorFlowPyTorchJAXReact,函数式、声明式和反应式编程的理念正在以更好的方式改变广泛的工具。

项目侧边栏1项目侧边栏2
推荐项目
Project Cover

豆包MarsCode

豆包 MarsCode 是一款革命性的编程助手,通过AI技术提供代码补全、单测生成、代码解释和智能问答等功能,支持100+编程语言,与主流编辑器无缝集成,显著提升开发效率和代码质量。

Project Cover

问小白

问小白是一个基于 DeepSeek R1 模型的智能对话平台,专为用户提供高效、贴心的对话体验。实时在线,支持深度思考和联网搜索。免费不限次数,帮用户写作、创作、分析和规划,各种任务随时完成!

Project Cover

白日梦AI

白日梦AI提供专注于AI视频生成的多样化功能,包括文生视频、动态画面和形象生成等,帮助用户快速上手,创造专业级内容。

Project Cover

有言AI

有言平台提供一站式AIGC视频创作解决方案,通过智能技术简化视频制作流程。无论是企业宣传还是个人分享,有言都能帮助用户快速、轻松地制作出专业级别的视频内容。

Project Cover

讯飞绘镜

讯飞绘镜是一个支持从创意到完整视频创作的智能平台,用户可以快速生成视频素材并创作独特的音乐视频和故事。平台提供多样化的主题和精选作品,帮助用户探索创意灵感。

Project Cover

讯飞文书

讯飞文书依托讯飞星火大模型,为文书写作者提供从素材筹备到稿件撰写及审稿的全程支持。通过录音智记和以稿写稿等功能,满足事务性工作的高频需求,帮助撰稿人节省精力,提高效率,优化工作与生活。

Project Cover

阿里绘蛙

绘蛙是阿里巴巴集团推出的革命性AI电商营销平台。利用尖端人工智能技术,为商家提供一键生成商品图和营销文案的服务,显著提升内容创作效率和营销效果。适用于淘宝、天猫等电商平台,让商品第一时间被种草。

Project Cover

Trae

Trae是一种自适应的集成开发环境(IDE),通过自动化和多元协作改变开发流程。利用Trae,团队能够更快速、精确地编写和部署代码,从而提高编程效率和项目交付速度。Trae具备上下文感知和代码自动完成功能,是提升开发效率的理想工具。

Project Cover

AIWritePaper论文写作

AIWritePaper论文写作是一站式AI论文写作辅助工具,简化了选题、文献检索至论文撰写的整个过程。通过简单设定,平台可快速生成高质量论文大纲和全文,配合图表、参考文献等一应俱全,同时提供开题报告和答辩PPT等增值服务,保障数据安全,有效提升写作效率和论文质量。

投诉举报邮箱: service@vectorlightyear.com
@2024 懂AI·鲁ICP备2024100362号-6·鲁公网安备37021002001498号