marimo
一個用於 Python 的反應式筆記本 — 執行可重現的實驗、使用 SQL 查詢、作為腳本執行、部署為應用程式,並使用 git 進行版本控制。以純 Python 儲存。
marimo 是什麼?
一個用於 Python 的反應式筆記本 — 執行可重現的實驗、使用 SQL 查詢、作為腳本執行、部署為應用程式,並使用 git 進行版本控制。以純 Python 儲存。全部在一個現代、AI 原生的編輯器中。
marimo 概覽
這是什麼
marimo 是一個反應式 Python 筆記本,目標是取代 Jupyter、Streamlit、Jupytext、ipywidgets、Papermill 等工具。筆記本以純 Python 檔案儲存,因此容易與 git 整合,也可直接作為腳本執行。這個環境專為可重現性設計:執行一個儲存格時,會自動執行相依的儲存格或將其標記為過時,保持程式碼與輸出的一致性。marimo 也支援第一等的 SQL 查詢、AI 原生功能,以及部署為互動式網頁應用或投影片。
主要功能
反應式執行:執行一個儲存格或與 UI 元件互動時,相依儲存格會自動執行或被標記為過時友善 git:以 .py 檔案(而非 JSON)儲存內建 SQL 引擎:可查詢資料框、資料庫、資料湖倉、CSV 或 Google Sheets,結果以 Python 資料框回傳AI 原生:可搭配 Claude Code 等 AI 代理,或使用內建 AI 助手,助手能取得記憶體中變數的上下文可重現:無隱藏狀態、確定性執行順序、內建套件管理(支援隔離的 venv 沙箱)互動式 UI:滑桿、下拉選單、資料框轉換器、聊天介面會自動重新執行相依程式碼一應俱全:包含 GitHub Copilot、AI 助手、Ruff 程式碼格式化、HTML 匯出、互動式資料框檢視器、VS Code 擴充、PyCharm 外掛
使用情境
marimo 適用於資料探索、可重現的實驗、建立互動式儀表板、對資料框和資料庫進行 SQL 查詢、從筆記本建立可分享的網頁應用或投影片,以及嵌入互動式視覺化。在研究、教學和資料新聞學等需要重視可重現性與一致性的場景中特別有用。
快速開始
安裝並執行入門教學:pip install marimo && marimo tutorial intro若要安裝額外依賴(SQL、AI 補全等):pip install "marimo[recommended]"建立筆記本:marimo edit以網頁應用執行:marimo run your_notebook.py以腳本執行:python your_notebook.py轉換 Jupyter 筆記本:marimo convert your_notebook.ipynb > your_notebook.py
授權與價格
授權為 Apache-2.0。marimo 是開源軟體。
內容整理自該專案公開的 README 與儲存庫資訊。