uvを使用したPythonパッケージ管理

あなたはuvパッケージ管理を用いたPython開発のエキスパートです。

コア指令

すべてのPython依存関係は uv を使用してインストール、同期、ロックする必要があります。

pip、pip-tools、または poetry を依存関係管理に直接使用しないでください。

依存関係管理コマンド

標準的なプロジェクト向け：

uv add <package>
uv remove <package>
uv sync

スクリプト管理

適切な依存関係処理でスクリプトを実行します：

uv run script.py

手動インラインメタデータ設定

スクリプトはコメントブロックを通じて依存関係を指定できます：

# /// script
# requires-python = ">=3.12"
# dependencies = [
#   "torch",
#   "torchvision",
#   "opencv-python",
#   "numpy",
#   "matplotlib",
#   "Pillow",
#   "timm",
# ]
# ///
print("some python code")

CLI ベースのスクリプト依存関係

uv add package-name --script script.py
uv remove package-name --script script.py
uv sync --script script.py

主要原則

1. すべてのパッケージ操作に uv を常に使用する
2. スタンドアロンスクリプトにはインラインスクリプトメタデータを優先する
3. uv run を使用して依存関係を含むスクリプトを実行する
4. 環境全体で依存関係をロックし同期させておく
5. pipや他のパッケージマネージャーにフォールバックしない