uv + Jupyter Notebook の環境構築

uv で仮想環境にパッケージを追加したが，Jupyter Notebook 上では ModuleNotFoundError が出る問題を解決する記事

手順

1. 作業ディレクトリを作成し，初期化．

   $ mkdir great-project
   $ uv init great-project
   $cd great-project/
   

2. 必要なパッケージを追加．この記事では例として numpy を追加する

   $ uv add numpy
   

3. 適当な名前でカーネルを作成．この記事ではカーネル名を my-kernel とした．

   $ uv add --dev ipykernel
   $ uv run ipython kernel install --user --name=my-kernel
   

4. Jupyter Notebook を起動．

   $ uv run --with jupyter jupyter notebook
   

   Jupyter Lab を起動したい場合は，次のコマンドを使えば良い．

   $ uv run --with jupyter jupyter lab
   

5. 起動後，右上の「New」ボタンから先ほど作った kernel を選択できる．
   my-kernel を選択すると， uv で追加したパッケージを使うことができる．
   

作成したカーネルの削除方法

以下のコマンドで消すことができる．

$ uv run --with jupyter jupyter kernelspec uninstall my-kernel

うまくいかない理由

Jupyter で参照している Python が，uv のそれとは違うことが原因．
参考にある記事を参照．

参考

• Using uv with Jupyter
• Remove the kernel on a Jupyter Notebook
• UV CLI Reference
• PythonにインストールしたモジュールがJupyterNotebookでModuleNotFoundErrorとなる。