🐥

【uv】uvによる仮想環境構築 クイックスタートガイド

2025/02/03に公開

n番煎じのuvの使い方説明、やっていきます。(MacOS, Linux向け)
主要コマンドと効果を簡潔に書いています。

1. インストール

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

・チェック

uv --version

2. Pyhton環境のインストール

・複数のpython環境のインストールが可能(切り替え可能)

# インストール
uv python install 3.10 3.11 3.12
# versionの固定
uv python pin 3.10

・インストール済みの環境確認

uv python list

3. 実行

・仮想環境の作成

uv init <プロジェクト名>

・有効/無効化(仮想環境への入出)

# 有効化
source .venv/bin/activate
# 無効化
deactivate

・スクリプトの実行

uv run example.py

・依存関係のインストール/追加

# venv環境構築(initの代わり)
uv venv <パス(省略可)>
# インストール(venv環境が必要)
uv pip sync requirements.txt
# 追加
uv add requests
# 除去
uv remove requests

・仮想環境の削除

rm -rf .venv

(venvは、1つのフォルダに対して1つの仮想環境を構築する手法。.venv_1のようなフォルダで異なる仮想環境を構築、管理することは可能)

4. Notebook環境

・環境構築

# 環境構築
uv venv jupKernel --python=python3.10.0
# 環境に入る(source: 指定ファイル内のコマンドを現在のシェルで実行される)
source jupKernel/bin/activate

・ipythonのインストール

uv pip install ipython 

・Jupyter Kernelの作成(nameは任意)

ipython kernel install --user --name=jupKernel

・Kernelの選択
※出てこない場合はリスタートすると出てくる場合があります。

cmd + shift + p同時押し → Python: Select Interpreterから作成したKernelを選択

参考

[1] uv (pythonパッケージマネージャー)の使い方 詳細版
[2] uv公式ドキュメント
[3] uv環境構築 Jupyter kernel + VS Code

Discussion