Skip to content

Installing uv#

スタンドアロンのインストーラかパッケージマネージャ(例えばpip install uv)を使ってuvをインストールしてください。

Standalone installer#

uvは、uvをダウンロードしてインストールするためのスタンドアロンインストーラを提供します。

macOS and Linux
$ curl -LsSf https://astral.sh/uv/install.sh | sh
Windows
$ powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

デフォルトでは、uvは~/.cargo/binにインストールされます。

Tip

インストールスクリプトは、使用前に検査できます。:

macOS and Linux
$ curl -LsSf https://astral.sh/uv/install.sh | less
Windows
$ powershell -c "irm https://astral.sh/uv/install.ps1 | more"

.. Alternatively, the installer or binaries can be downloaded directly from GitHub.

あるいは、インストーラまたはバイナリをGitHubから直接ダウンロードすることもできます。

URLに含めて特定のバージョンを要求します。:

macOS and Linux
$ curl -LsSf https://astral.sh/uv/0.2.11/install.sh | sh
Windows
$ powershell -c "irm https://astral.sh/uv/0.2.11/install.ps1 | iex"

Tip

スタンドアロンインストーラを使用してuvをインストールすると、自己更新が有効になります。:

$ uv self update

別のインストール方法を使用すると、自己更新は無効になります。代わりにパッケージマネージャのアップグレード方法を使用してください。

PyPI#

便宜上、uvはPyPIにパブリッシュされます。

PyPIからインストールする場合は、例えばpipxを使用して、分離された環境にuvをインストールすることをお勧めします。:

$ pipx install uv

ただし、pipも使用できます。:

$ pip install uv

Note

uvは、多くのプラットフォーム用に事前に構築されたディストリビューション(wheels)とともに出荷されます。特定のプラットフォームでwheelが使用できない場合、uvはRustツールチェーンを必要とするソースから構築されます。ソースからのuvの構築の詳細については、contributing setup guideを参照してください。

Homebrew#

uvはHomebrewのコアパッケージで利用できます。

$ brew install uv

Docker#

uvはDockerイメージをghcr.io/astral-sh/uvで提供しています。

詳細については、Dockerでのuvの使用のガイドを参照してください。

GitHub Releases#

uvリリースアーティファクトは、GitHub Releasesから直接ダウンロードできます。

各リリースページには、サポートされているすべてのプラットフォーム用のバイナリと、astral.shの代わりにgithub.com経由でスタンドアロンインストーラを使用するための手順が含まれています。

Next steps#

See the first steps or jump straight to the guides to start using uv.

uvの使用を開始するには、first stepsを参照するか、guidesに直接ジャンプします。