Skip to content

uvのインストール

インストール方法

uvをスタンドアロンインストーラーまたはお好みのパッケージマネージャーでインストールします。

スタンドアロンインストーラー

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

$ curl -LsSf https://astral.sh/uv/install.sh | sh

$ powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

特定のバージョンをリクエストするには、URLに含めます：

$ curl -LsSf https://astral.sh/uv/0.5.1/install.sh | sh

$ powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/0.5.1/install.ps1 | iex"

Tip

インストールスクリプトは使用前に確認できます：

$ curl -LsSf https://astral.sh/uv/install.sh | less

$ powershell -c "irm https://astral.sh/uv/install.ps1 | more"

また、インストーラーやバイナリはGitHubから直接ダウンロードできます。

カスタマイズされた uv インストールの詳細については、インストーラー設定のドキュメントを参照してください。

PyPI

便宜上、uvはPyPIに公開されています。

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

$ pipx install uv

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

$ pip install uv

Note

uvは多くのプラットフォーム向けに事前構築されたディストリビューション（ホイール）を提供しています。特定のプラットフォーム向けのホイールが利用できない場合、uvはソースからビルドされます。これにはRustツールチェーンが必要です。ソースからuvをビルドする詳細については、 貢献者のセットアップガイドを参照してください。

Cargo

uvはCargo経由で利用可能ですが、未公開のクレートに依存しているため、crates.ioではなくGitからビルドする必要があります。

$ cargo install --git https://github.com/astral-sh/uv uv

Homebrew

uvはcore Homebrewパッケージで利用可能です。

$ brew install uv

Winget

uvはwinget経由で利用可能です。

$ winget install --id=astral-sh.uv  -e

Docker

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

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

GitHubリリース

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

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

uvのアップグレード

uvがスタンドアロンインストーラーを介してインストールされている場合、オンデマンドで自己更新できます：

$ uv self update

Tip

uvの更新はインストーラーを再実行し、シェルプロファイルを変更する可能性があります。この動作を無効にするには、INSTALLER_NO_MODIFY_PATH=1を設定します。

他のインストール方法が使用されている場合、自己更新は無効になります。代わりにパッケージマネージャーのアップグレード方法を使用します。例えば、pipを使用する場合：

$ pip install --upgrade uv

シェルの自動補完

uvコマンドのシェル自動補完を有効にするには、次のいずれかを実行します：

# シェルを確認し（例：`echo $SHELL`）、次のいずれかを実行します：
echo 'eval "$(uv generate-shell-completion bash)"' >> ~/.bashrc
echo 'eval "$(uv generate-shell-completion zsh)"' >> ~/.zshrc
echo 'uv generate-shell-completion fish | source' >> ~/.config/fish/config.fish
echo 'eval (uv generate-shell-completion elvish | slurp)' >> ~/.elvish/rc.elv

Add-Content -Path $PROFILE -Value '(& uv generate-shell-completion powershell) | Out-String | Invoke-Expression'

uvxのシェル自動補完を有効にするには、次のいずれかを実行します：

# シェルを確認し（例：`echo $SHELL`）、次のいずれかを実行します：
echo 'eval "$(uvx --generate-shell-completion bash)"' >> ~/.bashrc
echo 'eval "$(uvx --generate-shell-completion zsh)"' >> ~/.zshrc
echo 'uvx --generate-shell-completion fish | source' >> ~/.config/fish/config.fish
echo 'eval (uvx --generate-shell-completion elvish | slurp)'' >> ~/.elvish/rc.elv

Add-Content -Path $PROFILE -Value '(& uvx --generate-shell-completion powershell) | Out-String | Invoke-Expression'

その後、シェルを再起動するか、シェルの設定ファイルをソースにします。

アンインストール

システムからuvを削除する必要がある場合は、uvおよびuvxバイナリを削除します：

$ rm ~/.local/bin/uv ~/.local/bin/uvx

$ rm $HOME\.local\bin\uv.exe
$ rm $HOME\.local\bin\uvx.exe

Tip

バイナリを削除する前に、uvが保存したデータを削除することをお勧めします：

$ uv cache clean
$ rm -r "$(uv python dir)"
$ rm -r "$(uv tool dir)"

Note

0.5.1 以前、uvは ~/.cargo/bin にインストールされていました。バイナリはそこから削除して
アンインストールできます。古いバージョンからのアップグレードでは、~/.cargo/bin から
バイナリを自動的に削除しません。

次のステップ

最初のステップを確認するか、ガイドに直接ジャンプしてuvの使用を開始してください。