Marimo — 面向数据与 AI 工作流的下一代 Python 笔记本

一个反应式的 Python 笔记本，可重现、对 Git 友好，并能作为脚本或应用部署。

文档 · Discord · 示例 · 图库 · YouTube

English | 繁體中文 | 简体中文 | 日本語 | Español

marimo 是一个反应式 Python 笔记本：运行一个单元格或与 UI 元素交互，marimo 会自动运行依赖的单元格（或将其标记为过时），保持代码和输出的一致性。marimo 笔记本存储为纯 Python 文件（具有一流的 SQL 支持），可作为脚本执行，也可作为应用部署。

亮点：

• 🚀 开箱即用：替代 jupyter、streamlit、jupytext、ipywidgets、papermill 等工具
• ⚡️ 反应式：运行一个单元格，marimo 会反应式地运行所有依赖的单元格或将其标记为过时
• 🖐️ 交互式：将滑块、表格、图表等绑定到 Python —— 无需回调函数
• 🐍 Git 友好：存储为 .py 文件
• 🛢️ 为数据设计：使用 SQL 查询数据框、数据库、数据仓库或湖仓，过滤和搜索数据框
• 🤖 AI 原生：使用 AI 生成单元格，专为数据处理工作定制
• 🔬 可重现：无隐藏状态，确定性执行，内置包管理
• 🏃 可执行：作为 Python 脚本执行，可通过 CLI 参数化
• 🛜 可分享：部署为交互式 Web 应用或幻灯片，通过 WASM 在浏览器中运行
• 🧩 可复用：从一个笔记本导入函数和类到另一个笔记本
• 🧪 可测试：在笔记本上运行 pytest
• ⌨️ 现代化编辑器：GitHub Copilot、AI 助手、vim 键绑定、变量浏览器等更多功能
• 🧑‍💻 使用你喜欢的编辑器：在 VS Code 或 Cursor 中运行，或在 neovim、Zed 或任何其他文本编辑器中编辑

pip install marimo && marimo tutorial intro

立即通过 molab，我们的免费在线笔记本 开始使用。或者跳转到快速入门了解 CLI 的基本用法。

一个反应式编程环境

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

反应式编程环境。
运行一个单元格，marimo 会通过自动运行引用其变量的单元格来做出_反应_，消除了手动重新运行单元格的易出错任务。删除一个单元格，marimo 会将其变量从程序内存中清除，消除隐藏状态。

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

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

交互式数据框。 快速翻页、搜索、过滤和排序数百万行数据，无需编写代码。

使用数据感知 AI 生成单元格。 使用 AI 助手生成代码，该助手高度专业化于数据处理，并了解内存中变量的上下文；零样本生成整个笔记本。自定义系统提示，使用你自己的 API 密钥，或使用本地模型。

使用 SQL 查询数据。 构建依赖于 Python 值的 SQL 查询，并使用我们内置的 SQL 引擎对数据框、数据库、湖仓、CSV、Google Sheets 或任何其他数据源执行查询，结果以 Python 数据框形式返回。

即使使用 SQL，你的笔记本仍然是纯 Python。

动态 Markdown。 使用由 Python 变量参数化的 Markdown 来讲述依赖于 Python 数据的动态故事。

内置包管理。 marimo 内置支持所有主流包管理器，让你可以在导入时安装包。marimo 甚至可以在笔记本文件中序列化包依赖，并在隔离的 venv 沙箱中自动安装它们。

确定性执行顺序。 笔记本根据变量引用（而非单元格在页面上的位置）以确定性顺序执行。组织你的笔记本以最好地适应你想要讲述的故事。

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

开箱即用。 marimo 内置 GitHub Copilot、AI 助手、Ruff 代码格式化、HTML 导出、快速代码补全、VS Code 扩展、交互式数据框查看器以及更多提升体验的功能。

快速入门

我们的 YouTube 频道上的 marimo 概念播放列表概述了许多功能。

安装。 在终端中运行：

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

要安装包含解锁 SQL 单元格、AI 补全等功能的额外依赖，请运行：

pip install "marimo[recommended]"

创建笔记本。

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

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

或使用我们的网页界面。

教程。
列出所有教程：

marimo tutorial --help

分享云端笔记本。 使用 molab（一个类似于 Google Colab 的云端 marimo 笔记本服务）来创建和分享笔记本链接。

有问题？

请查看我们文档中的 FAQ。

了解更多

marimo 易于上手，同时为高级用户提供了丰富的功能。例如，这是一个在 marimo 中制作的嵌入可视化器（在 molab 上实时尝试该笔记本！）：

查看我们的文档、使用示例和图库以了解更多。

教程	输入组件	图表	布局

贡献

我们感谢所有贡献！你不需要是专家也能提供帮助。请参阅 CONTRIBUTING.md 了解如何开始的更多细节。

有问题？请通过 Discord 联系我们。

社区

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

• 🌟 在 GitHub 上给我们 Star
• 💬 在 Discord 上与我们聊天
• 📧 订阅我们的 Newsletter
• ☁️ 加入我们的云服务等待列表
• ✏️ 发起 GitHub 讨论
• 🦋 在 Bluesky 上关注我们
• 🐦 在 Twitter 上关注我们
• 🎥 在 YouTube 上订阅我们
• 🤖 在 Reddit 上关注我们
• 🕴️ [在 LinkedIn 上关注我们](https://www.linkedin.com/company/mar