uv — Pythonのパッケージ・環境管理を1つに統合するRust製高速ツール
astral-sh/uv
★ 92,248 ・ Rust ・ Apache-2.0
概要
uv は、Rust 言語で開発されている Python 向けのパッケージマネージャー兼プロジェクトマネージャーです。高速な Python リンター・フォーマッターとして知られる Ruff などを手がける Astral 社によって開発されています。
Python のエコシステムでは、長年にわたりパッケージのインストールに pip、仮想環境の作成に virtualenv、プロジェクトや依存関係の固定に pip-tools や poetry、CLI ツールの分離実行に pipx、そして Python 自体のバージョン切り替えに pyenv といった複数のツールを組み合わせて使い分ける状況が続いていました。
uv は、これら個別に存在していた複数のツールの役割を単一のバイナリでカバーすることを目標として設計されています。Rust による実装と最適化された設計により、README では既存の pip と比較して 10〜100 倍の速度向上をうたっています。日々のパッケージインストールや CI/CD パイプラインにおけるセットアップ時間を短縮したい開発者や、乱立したツールチェーンを1つに整理したいチームに向いています。
主な特徴
- 複数の Python 管理ツールの代替:
pip、pip-tools、pipx、poetry、pyenv、twine、virtualenvなどの機能を包括し、単一の CLI ツールで運用できます。 - 高いパフォーマンス: Rust で実装されており、ベンチマーク資料によれば
pipよりも 10〜100 倍高速に動作します。 - 包括的なプロジェクト管理とユニバーサルロックファイル: プラットフォーム間で共通して利用可能なロックファイル(universal lockfile)や、大規模プロジェクト向けのワークスペース(Cargo スタイル)をサポートしています。
- スクリプトの単体実行とインライン依存関係: PEP 723 準拠のインライン依存関係メタデータを記述した単一の
.pyファイルを、自動的に一時的な隔離環境を用意して直接実行できます。 - Python 本体のインストールとバージョン管理: システムに依存せず、必要な Python バージョンを直接ダウンロード・インストールし、ディレクトリごとにピン留めして切り替えることができます。
- グローバルキャッシュによるディスク効率: パッケージの重複保持を避けるグローバルキャッシュ機構を備えており、ディスク容量の消費を抑制します。
- 既存環境と親和性の高い
uv pipインターフェース: 従来のpipやpip-toolsと互換性のあるコマンド体系(compile、sync、install等)を備えており、既存のワークフローを大きく変えずに導入できます。
使い方
インストール
uv はスタンドアロンインストーラー、または PyPI 経由で導入できます。Rust や Python の実行環境があらかじめ用意されていなくても、スタンドアロンインストーラーを使用すれば導入可能です。
macOS および Linux の場合:
curl -LsSf https://astral.sh/uv/install.sh | sh
Windows の場合(PowerShell):
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
pip や pipx を使用してインストールすることも可能です:
pip install uv
# または
pipx install uv
スタンドアロンインストーラーでインストールした場合、次のコマンドで uv 自身を最新版にアップデートできます。
uv self update
プロジェクトの管理
プロジェクトの新規作成、パッケージの追加、スクリプトの実行、ロックファイルの生成は直感的なサブコマンドで行えます。
$ uv init example
Initialized project `example` at `/home/user/example`
$ cd example
# 依存パッケージを追加(自動的に仮想環境が作成されます)
$ uv add ruff
# プロジェクト環境でツールを実行
$ uv run ruff check
# ロックファイルの更新と環境の同期
$ uv lock
$ uv sync
スクリプトの実行(インラインメタデータ)
単一のスクリプトファイルに対して依存ライブラリをメタデータとして埋め込み、隔離された環境で実行することができます。
$ echo 'import requests; print(requests.get("https://astral.sh"))' > example.py
$ uv add --script example.py requests
$ uv run example.py
ツールの実行とインストール
Python パッケージとして配布されている CLI ツールを、一時的な環境で即座に実行したり、システムグローバルにインストールしたりできます。
# 一時環境でツールを実行(uv tool run のエイリアス)
$ uvx pycowsay 'hello world!'
# ツールをインストールして常時利用可能にする
$ uv tool install ruff
$ ruff --version
Python バージョンの管理
Python 自体をダウンロードし、バージョンを切り替えて使用する機能も備えています。
# 複数の Python バージョンをインストール
$ uv python install 3.12 3.13 3.14
# 特定バージョンを指定して仮想環境を作成
$ uv venv --python 3.12.0
# カレントディレクトリで使用するバージョンを固定
$ uv python pin 3.11
pip 互換コマンドの利用
既存の requirements.txt を用いたワークフローでも、uv pip コマンドを通じて高速化の恩恵を受けることができます。
# requirements.in からプラットフォーム非依存の lock を生成
$ uv pip compile requirements.in --universal --output-file requirements.txt
# 仮想環境を作成
$ uv venv
# ロックファイルを環境に同期
$ uv pip sync requirements.txt
技術的なポイント
uv の高速性と設計は、いくつかの技術的選定や既存の優れたパッケージマネージャーの手法に基づいています。
- PubGrub アルゴリズムの採用: 依存関係のリゾルバ(解決器)には、Dart のパッケージマネージャーなどで実績のある
PubGrubアルゴリズムを採用しています(Rust 製ライブラリpubgrubを利用)。複雑なバージョン競合が発生した際にも、矛盾の原因を追跡しやすく高速な解決が可能です。 - Cargo ベースの Git 実装: Git リポジトリからのパッケージ取得・依存処理には、Rust のパッケージマネージャーである Cargo の Git 実装をベースとした仕組みが活用されています。
- 他言語パッケージマネージャーからの知見: README の謝辞(Acknowledgements)によると、pnpm、Orogene、Bun といった JavaScript/Node.js 界隈の高速なツール群から最適化の着想を得ています。また、Python の実験的パッケージマネージャーである Posy から学んだ Windows 向けトランポリン(trampoline)実装を取り入れるなど、マルチプラットフォームでの確実な実行を考慮した設計が行われています。
- クロスプラットフォームなロックファイル: プラットフォーム(OS やアーキテクチャ)ごとに依存解決結果が異なりがちな Python において、ユニバーサルロックファイルを生成することで、異なる環境間でも再現性のある構成を実現しています。
注意点
- ライセンス: Apache License 2.0 または MIT License のデュアルライセンスとなっており、利用者の都合に合わせて選択できます。
- 対応環境: macOS、Linux、Windows を公式にサポートしています。詳細なプラットフォーム要件については公式ドキュメントを参照してください。
- 本番環境での利用: README の FAQ によると、uv は安定版(stable)として位置づけられており、すでに本番環境で広く利用されていると記載されています。
- 既存エコシステムとの差異:
uv pipによる pip 互換モードが提供されているものの、プロジェクト全体の管理(uv initやuv sync)を行う場合は、uv が標準とするプロジェクト構成やロックファイルの形式を採用することになります。既存のツール(Poetry や Pipenv など)から移行する際は、各ツールの設定ファイル(pyproject.tomlの各セクション等)の取り扱い方針をドキュメントで確認することが推奨されます。
まとめ
uv は、Rust の性能を活かして Python のパッケージ解決・仮想環境構築・バージョン管理を飛躍的に高速化するオールインワンツールです。pip、pipx、poetry、pyenv などに分散していた開発ワークフローを1つの CLI に集約でき、ローカル開発環境の整備から CI/CD の実行時間削減まで幅広い効果が期待できます。





