みなさん、<code>marimo</code>ってご存じですか？ 
<iframe id="zenn-embedded__e3ff113ed9ec4" src="https://embed.zenn.studio/card#zenn-embedded__e3ff113ed9ec4" data-content="https%3A%2F%2Fdocs.marimo.io%2F" frameborder="0" scrolling="no" loading="lazy"></iframe><a href="https://docs.marimo.io/" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://docs.marimo.io/</a> 
最近<code>marimo</code>を触ってみたんですが、これが思った以上に便利でびっくりしました。 
このツールだけで完結できる場面が多くて、しかもUIがリアルタイムに反応してくれるので、作っていてすごく楽しいんです🎶 
驚くほど簡単で直感的に使えますし、「試してみたい！」と気持ちがどんどん湧いてきました。
というわけで、この記事ではそんなmarimoの魅力や、基本的な使い方について紹介していきたいと思います。 
ちょっとでも「面白そう」と思ってもらえたら嬉しいです。
<h2 id="%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB" data-line="9" class="code-line">
<a class="header-anchor-link" href="#%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB" aria-hidden="true"></a> はじめに</h2>
Pythonでデータ分析や機械学習をするとき、まず思い浮かぶのが <code>Jupyter Notebook</code> という人も多いんじゃないでしょうか。 
定番ツールとして長く使われてきたJupyterですが、実際に使ってみると「セルの実行順がバラバラになって混乱する」「どこで何が定義されてるか分かりづらい」「Gitで管理しづらい」など、地味に困るポイントもあります。
そこで登場したのが、<code>marimo</code>。リアクティブな実行モデルとGitフレンドリーな設計を持つ、次世代のPythonノートブックです。
<h2 id="marimo%E3%81%A8%E3%81%AF%EF%BC%9F" data-line="15" class="code-line">
<a class="header-anchor-link" href="#marimo%E3%81%A8%E3%81%AF%EF%BC%9F" aria-hidden="true"></a> marimoとは？</h2>
marimoは、リアクティブに動作するPythonノートブック環境です。 
一言でいうと、コードを書いたらすぐ反映される、しかも整合性が保たれるという気持ちよさがあるツールです。
セルを実行すると、関連するセルも自動で再実行されるので、「あれ、どこで定義したっけ？」とか「順番間違えて動かない…」のようなJupyterあるあるが起きにくいです。コードと出力が常に一致しているというのは、地味だけどすごくありがたいと思います。
<img src="https://storage.googleapis.com/zenn-user-upload/dc2077e5a46d-20251104.gif" alt="" class="md-img" loading="lazy"> 
リアクティブなプログラミング環境 
下のセルを実行すると、上のセルの結果も自動で変わります。 
これは、marimoがセル同士の関係を「DAG（有向非巡回グラフ）」として管理しているからです。 
※そのため、異なるセル間で変数を再代入したり、変数同士が循環的に依存するような関係を定義することはできません。
また、ノートブックは <code>.py</code> ファイルとして保存されるので、Gitでの管理もスムーズです。 
履歴が追いやすくて、チームでの開発にも向いてます。 
作ったノートブックをそのままWebアプリとして公開するのも簡単なので、ちょっとしたツールやデモをサクッと共有できるのも嬉しいポイントです。
<h2 id="jupyter%E3%81%A8%E3%81%AE%E6%AF%94%E8%BC%83" data-line="31" class="code-line">
<a class="header-anchor-link" href="#jupyter%E3%81%A8%E3%81%AE%E6%AF%94%E8%BC%83" aria-hidden="true"></a> Jupyterとの比較</h2>
jupyterを使い慣れている方にとっては、「いったい何がどう違う？」「jupyterで十分では」と思うかもしれません。 
そこで、Jupyterとmarimoの違いをざっくり表にまとめてみました👇
<table data-line="35" class="code-line">
<thead data-line="35" class="code-line">
<tr data-line="35" class="code-line">
<th>比較項目</th>
<th>Jupyter Notebook</th>
<th>marimo</th>
</tr>
</thead>
<tbody data-line="37" class="code-line">
<tr data-line="37" class="code-line">
<td>実行順序</td>
<td>セルの順番に依存</td>
<td>依存関係に基づいて自動再実行（リアクティブ）</td>
</tr>
<tr data-line="38" class="code-line">
<td>UI連携</td>
<td>
<code>ipywidgets</code>などで手動設定</td>
<td>
<code>mo.ui</code>で簡単に連携、値変更で自動更新</td>
</tr>
<tr data-line="39" class="code-line">
<td>ファイル形式</td>
<td>
<code>.ipynb</code>（JSON）</td>
<td>
<code>.py</code>（Git管理に最適）</td>
</tr>
<tr data-line="40" class="code-line">
<td>再現性</td>
<td>セッション状態に依存</td>
<td>状態が明示的に管理され、常に一貫性あり</td>
</tr>
<tr data-line="41" class="code-line">
<td>アプリ化</td>
<td>別ツールが必要</td>
<td>
<code>marimo run</code>でWebアプリ化可能</td>
</tr>
</tbody>
</table>
さらに実際に私が使ってみて便利だと感じたのが、必要なライブラリが足りないときに、画面上でインストール方法やバージョンを選べること。 そして、エラーが出たときには内容をもとに自動で修正してくれる機能が備わっていることです。
<img src="https://storage.googleapis.com/zenn-user-upload/0f6f9428def3-20251104.png" alt="" width="250" class="md-img" loading="lazy"> 
install 
初心者の私にとって、同じ画面上でGUI操作ができ、そのままライブラリをインストールできるのがすごく便利で安心感がありました。
<img src="https://storage.googleapis.com/zenn-user-upload/111b93b6f97b-20251104.png" alt="" width="250" class="md-img" loading="lazy"> 
fix エラーの自動修正提案 
さらに、エラー内容に「コピー」ボタンが表示されるため、そのままクリップボードに保存できます。 
調べたり共有しやすいのは嬉しいポイントです。
<h2 id="marimo%E3%81%AE%E4%B8%BB%E3%81%AA%E6%A9%9F%E8%83%BD%E3%81%A8%E7%89%B9%E5%BE%B4" data-line="55" class="code-line">
<a class="header-anchor-link" href="#marimo%E3%81%AE%E4%B8%BB%E3%81%AA%E6%A9%9F%E8%83%BD%E3%81%A8%E7%89%B9%E5%BE%B4" aria-hidden="true"></a> marimoの主な機能と特徴</h2>
公式ドキュメントの内容を引用してご紹介します。
<blockquote data-line="58" class="code-line">
⚡️ リアクティブ実行：依存セルが自動更新される 
🖐️ インタラクティブUI：スライダー・テーブル・チャートなどを簡単に追加 
🐍 Gitフレンドリー：ノートブックは.py形式で保存 
🛢️ SQL対応：Python変数を使ったSQLクエリが可能 
🤖 AI補完：データに特化したAIアシスタントでコード生成 
🔬 再現性重視：隠れた状態なし、決定論的な実行順序 
🛜 Webアプリ化：ノートブックをそのままWebアプリやスライドに変換 
🧪 テスト可能：pytestでノートブックをテスト 
⌨️ モダンエディタ：Copilot、Vim操作、変数ビューアなどを搭載
</blockquote>
<img src="https://storage.googleapis.com/zenn-user-upload/248979e6b182-20251104.gif" alt="" class="md-img" loading="lazy"> 
埋め込みビジュアライザー
<h2 id="%E5%AE%9F%E9%9A%9B%E3%81%AB%E4%BD%BF%E3%81%A3%E3%81%A6%E3%81%BF%E3%82%88%E3%81%86" data-line="72" class="code-line">
<a class="header-anchor-link" href="#%E5%AE%9F%E9%9A%9B%E3%81%AB%E4%BD%BF%E3%81%A3%E3%81%A6%E3%81%BF%E3%82%88%E3%81%86" aria-hidden="true"></a> 実際に使ってみよう</h2>
環境：Windows11 
パッケージのインストールには<code>uv</code>を使用したので、そちらのコマンドも併せて紹介していきます。
<h3 id="marimo%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB" data-line="76" class="code-line">
<a class="header-anchor-link" href="#marimo%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB" aria-hidden="true"></a> marimoのインストール</h3>
<div class="code-block-container"><pre class="language-bash"><code class="language-bash code-line" data-line="77">pip install marimo
uv add marimo　#uv経由
</code></pre></div><h3 id="%E3%83%81%E3%83%A5%E3%83%BC%E3%83%88%E3%83%AA%E3%82%A2%E3%83%AB%E3%82%92%E8%B5%B7%E5%8B%95%E3%81%99%E3%82%8B" data-line="82" class="code-line">
<a class="header-anchor-link" href="#%E3%83%81%E3%83%A5%E3%83%BC%E3%83%88%E3%83%AA%E3%82%A2%E3%83%AB%E3%82%92%E8%B5%B7%E5%8B%95%E3%81%99%E3%82%8B" aria-hidden="true"></a> チュートリアルを起動する</h3>
<div class="code-block-container"><pre class="language-bash"><code class="language-bash code-line" data-line="83">marimo tutorial intro
uv run marimo tutorial intoro #uv経由
</code></pre></div>marimoのチュートリアル画面が表示されます。
<h3 id="%E3%83%8E%E3%83%BC%E3%83%88%E3%83%96%E3%83%83%E3%82%AF%E3%82%92%E6%96%B0%E8%A6%8F%E4%BD%9C%E6%88%90%E3%83%BB%E7%B7%A8%E9%9B%86%E3%81%99%E3%82%8B" data-line="89" class="code-line">
<a class="header-anchor-link" href="#%E3%83%8E%E3%83%BC%E3%83%88%E3%83%96%E3%83%83%E3%82%AF%E3%82%92%E6%96%B0%E8%A6%8F%E4%BD%9C%E6%88%90%E3%83%BB%E7%B7%A8%E9%9B%86%E3%81%99%E3%82%8B" aria-hidden="true"></a> ノートブックを新規作成・編集する</h3>
<h4 id="%E6%96%B0%E8%A6%8F%E4%BD%9C%E6%88%90%EF%BC%88%E7%A9%BA%E3%81%AE%E3%83%8E%E3%83%BC%E3%83%88%E3%83%96%E3%83%83%E3%82%AF%EF%BC%89" data-line="90" class="code-line">
<a class="header-anchor-link" href="#%E6%96%B0%E8%A6%8F%E4%BD%9C%E6%88%90%EF%BC%88%E7%A9%BA%E3%81%AE%E3%83%8E%E3%83%BC%E3%83%88%E3%83%96%E3%83%83%E3%82%AF%EF%BC%89" aria-hidden="true"></a> 新規作成（空のノートブック）</h4>
<div class="code-block-container"><pre class="language-bash"><code class="language-bash code-line" data-line="91">marimo edit my_notebook.py
uv run marimo edit my_notebook.py #uv経由
</code></pre></div>このコマンドで <code>my_notebook.py</code> というPythonファイルが作成され、marimoのエディタが起動します。
<h4 id="%E6%97%A2%E5%AD%98%E3%83%8E%E3%83%BC%E3%83%88%E3%83%96%E3%83%83%E3%82%AF%E3%81%AE%E7%B7%A8%E9%9B%86" data-line="97" class="code-line">
<a class="header-anchor-link" href="#%E6%97%A2%E5%AD%98%E3%83%8E%E3%83%BC%E3%83%88%E3%83%96%E3%83%83%E3%82%AF%E3%81%AE%E7%B7%A8%E9%9B%86" aria-hidden="true"></a> 既存ノートブックの編集</h4>
すでにある <code>.py</code> ファイルを編集したい場合も同様に
<div class="code-block-container"><pre class="language-bash"><code class="language-bash code-line" data-line="99">marimo edit existing_notebook.py
uv run marimo edit existing_notebook.py #uv経由
</code></pre></div><h3 id="%E3%83%8E%E3%83%BC%E3%83%88%E3%83%96%E3%83%83%E3%82%AF%E3%82%92web%E3%82%A2%E3%83%97%E3%83%AA%E3%81%A8%E3%81%97%E3%81%A6%E5%AE%9F%E8%A1%8C" data-line="104" class="code-line">
<a class="header-anchor-link" href="#%E3%83%8E%E3%83%BC%E3%83%88%E3%83%96%E3%83%83%E3%82%AF%E3%82%92web%E3%82%A2%E3%83%97%E3%83%AA%E3%81%A8%E3%81%97%E3%81%A6%E5%AE%9F%E8%A1%8C" aria-hidden="true"></a> ノートブックをWebアプリとして実行</h3>
作成したノートブックをアプリとして起動するには、
<div class="code-block-container"><pre class="language-bash"><code class="language-bash code-line" data-line="106">marimo run my_notebook.py
uv run marimo run my_notebook.py　　#uv経由
</code></pre></div>この状態では、コードは非表示になり、UIだけが表示されるWebアプリとして動作します。
<h2 id="marimo%E6%B4%BB%E7%94%A8%E4%BE%8B%EF%BC%9A%E3%83%87%E3%83%A2" data-line="112" class="code-line">
<a class="header-anchor-link" href="#marimo%E6%B4%BB%E7%94%A8%E4%BE%8B%EF%BC%9A%E3%83%87%E3%83%A2" aria-hidden="true"></a> marimo活用例：デモ</h2>
UI連携：<code>mi.slider</code> を使ってインタラクティブなスライダーを作成し、サイン波の周波数を変更しながらリアルタイムに描画します。
<div class="code-block-container"><pre class="language-py"><code class="language-py code-line" data-line="114"># cell: スライダーの作成
import marimo as mo

slider = mo.ui.slider(1, 10, value=5, label="周波数")
slider
</code></pre></div><div class="code-block-container"><pre class="language-py"><code class="language-py code-line" data-line="121"># cell: スライダーの値に応じて描画
import numpy as np
import matplotlib.pyplot as plt

# スライダーの値を取得
freq = slider.value

# データ生成
x = np.linspace(0, 2 * np.pi, 500)
y = np.sin(freq * x)

# 描画
fig, ax = plt.subplots()
ax.plot(x, y)
ax.set_title(f"sin({freq}x)")
ax.grid(True)
fig
</code></pre></div><img src="https://storage.googleapis.com/zenn-user-upload/a29928bf4c1d-20251104.gif" alt="" class="md-img" loading="lazy"> 
スライダーの値を変更すると、それに応じて周波数もリアルタイムに更新され、グラフが描画されます。
＿＿＿ 
11/10追記
とても簡単な例になりますが、Markdown＋グラフ(Altair,Plotlyなど)や表で月次レポート作成なども 
<img src="https://storage.googleapis.com/zenn-user-upload/13acdd6b8957-20251110.png" alt="" class="md-img" loading="lazy"> 
Webアプリとしてプレゼン用に開く
インタラクティブに見せるWebスライドにもなりますし、PDFやHTMLに保存して配布も可能。
<h2 id="%E3%81%8A%E3%82%8F%E3%82%8A%E3%81%AB" data-line="153" class="code-line">
<a class="header-anchor-link" href="#%E3%81%8A%E3%82%8F%E3%82%8A%E3%81%AB" aria-hidden="true"></a> おわりに</h2>
marimoは、Jupyterが抱える課題をうまく解決してくれる新しいノートブック環境です。
特にこんな人にはおすすめなのではないでしょうか：
<ul data-line="158" class="code-line">
<li data-line="158" class="code-line">
セルの実行順や状態の再現にいつも悩まされている
</li>
<li data-line="160" class="code-line">
ノートブックをGitでちゃんと管理したい
</li>
<li data-line="162" class="code-line">
インタラクティブなデータ分析や教育用コンテンツを作ってみたい
</li>
<li data-line="164" class="code-line">
PythonスクリプトをそのままWebアプリとして公開したい！
</li>
</ul>
今後は、AIによるコード補完やSQLとの連携、クラウド上での共有（molab）といった機能も活用し、データ分析や教育、アプリ開発など、さまざまなシーンでmarimoが活躍してくれるはずです！
今回紹介したもの以外にも、実用的で面白そうな機能がたくさんあるようです。 
<img src="https://storage.googleapis.com/zenn-user-upload/e9e10e4c8c20-20251104.png" alt="" class="md-img" loading="lazy">(<a href="https://docs.marimo.io/guides/working_with_data/plotting/#altair" target="_blank" rel="nofollow noopener noreferrer">https://docs.marimo.io/guides/working_with_data/plotting/#altair</a>) marimo guideより

Jupyterよりも marimoが使いやすい理由

ノートブックを新規作成・編集する

ノートブックをWebアプリとして実行

Discussion