marimo

marimo 是一款革命性的开源 Python 笔记本，它为现代数据科学和人工智能时代重新构想了交互式计算。与将内容存储在容易出错的 JSON 文件中的传统笔记本不同，marimo 笔记本是纯粹的 Python 脚本（.py 文件）。这一根本性的设计选择使其具有可复现性、Git 友好性、可测试性，并能作为标准 Python 模块重复使用。marimo 引入了响应式执行模型，更新单个单元格会自动触发所有相关单元格的执行，从而消除了隐藏状态和为确保一致性而手动重新运行代码的繁琐任务。这创造了一个流畅、直观且不易出错的开发环境。

marimo 由一支在谷歌、Palantir 和 PyData 生态系统拥有丰富经验的团队开发，旨在弥合实验性原型设计与生产级应用之间的差距。它使开发人员和数据科学家能够直接从笔记本中构建复杂的交互式 Web 应用程序，而无需编写任何前端代码。这些笔记本可以无缝地作为由 WebAssembly 驱动的交互式 HTML 文件共享，或使用 marimo 命令行界面部署为强大的 Web 应用程序。

如何使用 marimo

marimo 的入门过程非常简单，旨在提供流畅的开发者体验。首先，使用 pip 安装它：

$ pip install marimo

安装后，您可以启动入门教程以熟悉其响应式范式：

$ marimo tutorial intro

要创建或编辑笔记本，只需使用 marimo 命令并指定一个 Python 文件：

$ marimo edit my_notebook.py

在基于 Web 的编辑器中，您可以像在其他笔记本中一样在单元格中编写 Python 代码。然而，marimo 的强大之处在于其特殊功能。您可以将滑块和下拉菜单等 UI 元素直接绑定到 Python 变量。当用户与小部件交互时，相应的变量会更新，所有使用此变量的下游单元格都会响应式地重新运行。您还可以在专用的 SQL 单元格中直接编写 SQL 查询，与 DuckDB、SQLite、Postgres 等数据库进行交互。要共享您的工作，您可以将其作为只读应用程序运行，或将其导出为独立的 HTML 文件：

# 作为交互式应用运行
$ marimo run my_notebook.py

# 导出为 HTML
$ marimo export my_notebook.py --to html

集成的 AI 助手可用于生成代码、解释概念和调试问题，支持来自 OpenAI、Anthropic、Google Gemini 的模型以及通过 Ollama 运行的本地模型。

marimo 的核心功能

• 响应式执行： 代码和输出保持完美同步。修改一个单元格会自动更新所有相关的单元格，消除隐藏状态并确保可复现性。
• Git 友好格式： 笔记本保存为标准的 Python（.py）文件，而不是复杂的 JSON。这使得差异（diffs）清晰可读，让使用 Git 进行版本控制变得无缝。
• AI 原生编辑器： 集成了 AI 辅助功能，包括类似 GitHub Copilot 的自动补全、上下文感知聊天和内联编辑。它支持主流 AI 模型以加速开发。
• 内置 SQL 单元格： 使用 SQL 原生查询数据库和数据帧。查询结果可以利用 Python 的全部功能进行无缝转换和可视化。
• 交互式 UI 元素： 使用丰富的窗口小部件（如滑块、下拉菜单和交互式数据帧 GUI）构建交互式用户界面，无需任何前端专业知识。
• 无缝部署： 从原型笔记本轻松过渡到生产级工具。将笔记本部署为只读 Web 应用，在管道中作为 Python 脚本运行，或将其导出为独立的 HTML 文件。
• 可复现的环境： marimo 可以在笔记本文件中序列化包依赖项，并自动创建临时的虚拟环境，确保笔记本在任何地方都能一致地运行。
• 丰富的开发者体验： 编辑器包括 vim 快捷键、代码格式化、调试面板、丰富的热键和 VS Code 扩展等现代功能。

marimo 的使用案例

marimo 的多功能性使其适用于不同领域的广泛应用：

• AI 和机器学习开发： 快速原型设计和测试 AI 模型。为大型语言模型（LLM）构建交互式界面，如聊天机器人和生成式 UI 工具。创建自定义的数据标注和评估仪表板，以微调和比较模型。
• 数据探索与可视化： 使用响应式图表和数据帧 GUI 交互式地探索数据集。在图表中所做的选择可以自动更新下游的分析和可视化，从而创建一个动态的探索性工作流程。
• 科学研究与教育： 通过具体的交互式应用来传达研究成果。开发引人入胜的教育材料，让学生能够实时地实验各种概念，例如模拟物理过程或探索数学函数。
• 内部工具与仪表板： 仅使用 Python 构建和维护内部工具，如财务计算器、NLP 模型比较仪表板或数据标注界面。这消除了管理独立前端和后端服务的复杂性。

marimo 的优势特点

与 Jupyter 等传统笔记本环境相比，marimo 具有显著优势：

• 设计上的可复现性： 响应式的无环数据流图保证了笔记本以确定性的顺序执行，防止了困扰其他系统的常见“乱序执行”问题。
• 简化的版本控制： 通过使用纯 Python 格式，marimo 解决了在笔记本 JSON 文件中解决合并冲突的噩梦，从而实现了通过 Git 的真正协作。
• 从笔记本到应用，瞬间完成： marimo 统一了开发和部署过程。您在笔记本中构建的就是应用程序，极大地减少了共享工作所需的时间和精力。
• 现代化和集成的工具链： 它结合了现代开发的最佳实践，包括内置的 AI 辅助、一流的 SQL 支持和强大的交互式组件，所有这些都在一个单一、内聚的环境中。
• 开源和社区驱动： 作为一个在 GitHub 和 Discord 上拥有活跃社区的免费开源工具，marimo 在用户贡献和反馈的推动下不断发展。

定价和计划

marimo 本质上是一个免费的开源项目。核心的 marimo 笔记本库及其命令行界面可供任何人免费使用。您可以在本地机器或自己的服务器上安装和运行它。此外，该项目还提供 molab，一个用于运行和共享 marimo 笔记本的云平台，目前也免费提供。这使得 marimo 成为个人、学生和专业团队都极易获得的工具。