エラー内容
Poetry環境を作成し、VSCodeでカーネルを選択して.ipynbのセルを実行しようとしたところ、下記のエラーになった。
選択したカーネル
エラー文
'Python 3.12.3' でセルを実行するには、 ipykernel パッケージが必要です。
次のコマンドを実行して、'ipykernel' を Python 環境にインストールします。
コマンド: '/usr/local/bin/python3 -m pip install ipykernel -U --user --force-reinstall'
解消法
ググってもよくわからなかったのでChatGPTにきいてみると、仮想環境用のカーネルを登録すればよいとのことだったので、実施してみると無事一発で解消した。
VSCodeのJupyter Notebook拡張機能が、Poetryで作成した仮想環境のipykernelを認識していないことで発生するエラーらしい。
1. Poetry環境で必要なパッケージをインストール
まず、Poetryでipykernelをインストールする必要があります。ターミナルを開いて、プロジェクトディレクトリに移動し、以下のコマンドを実行します。
poetry add ipykernel
2. 仮想環境のカーネルを登録
次に、Poetryの仮想環境をJupyterに認識させるため、仮想環境のPython実行ファイルを使ってカーネルを登録します。
poetry run python -m ipykernel install --user --name=your_env_name --display-name "Python (your_env_name)"
ここで、your_env_nameは仮想環境の名前です。好きな名前を付けてください。
3. VSCodeでカーネルを選択
VSCodeを再起動し、.ipynbファイルを再度開きます。次に、ノートブックの右上にあるカーネル選択メニュー（「Python 3.12.3」などと書かれている部分）をクリックし、先ほど登録したカーネルを選択します。
4. 必要な拡張機能の確認
VSCodeに以下の拡張機能がインストールされていることを確認します。
Jupyter
Python
これらがインストールされていない場合、VSCodeの拡張機能マネージャからインストールしてください。
5. 再試行
これで、.ipynbファイルのセルを実行して、エラーが解消されているか確認します。
結果
上記を試した結果、「Jupyter Kernel...」というのが選べるようになり、そこに先程作成したカーネルが表示されるので、それを選択すればよい。
ただ、最初に示した.venv/bin/pythonのカーネルを選択したままでも通るようになった。
まとめ
エラーを投げるとだいたい1発で解消に導いてくれるので、ChatGPT先生はすごい。
同様のエラーがおきた方の参考になれば嬉しいです。