python-uv

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 やその他のパッケージマネージャーに決して切り替えない