既存の uv プロジェクトで marimo を起動する場合は、プロジェクトディレクトリ内で以下のコマンドを実行する。
```bash
uv run marimo edit my_notebook.py
```
このコマンドは、プロジェクトの仮想環境 (`.venv`) 内で marimo を起動し、`pyproject.toml` で定義された依存関係が利用可能な状態でノートブックを実行する。
## プロジェクトへの marimo の追加
`marimo` を開発依存関係としてプロジェクトに追加する場合は、以下のコマンドを実行する:
```bash
uv add --dev marimo
```
これにより、`pyproject.toml` の `dev-dependencies` に marimo が追加され、チーム全体で同じ環境を共有できる。
```toml
[project]
name = "my-project"
version = "0.1.0"
description = "Add your description here"
readme = "README.md"
requires-python = ">=3.13"
dependencies = [
"polars>=1.19.0",
]
[dependency-groups]
dev = [
"marimo>=0.10.16",
]
```
## メリット
- **依存関係の共有**: プロジェクトの依存関係がすべて利用可能で、別途インストールする必要がない
- **チーム開発**: `pyproject.toml` を共有することで、チーム全体が同じ環境で開発できる
- **環境の統一**: 本番環境と開発環境で同じ依存関係を使用できる
## 関連ノート
- **[前提]** [[uv で Python プロジェクトを新規作成する]]: 本ノートの起動はプロジェクトが用意されていることが前提
- **[前提]** [[uv を macOS にインストールする]]: 本ノートの操作は uv が使える状態が前提
- **[対比]** [[marimo をノートブックごとに独立した隔離環境 (sandbox) で起動する]]: 本ノートのプロジェクト紐付け型とは別の、単発ノートブック向け運用