Skip to content

Pythonのインストール

Pythonがすでにシステムにインストールされている場合、uvは設定なしでそれを検出して使用します。ただし、uvはPythonのバージョンをインストールおよび管理することもできます。

Tip

uvは必要に応じて自動的にPythonのバージョンを取得します。Pythonをインストールする必要はありません。

はじめに

最新のPythonバージョンをインストールするには:

$ uv python install

これにより、システムにPythonがすでにインストールされている場合でも、uv管理のPythonバージョンがインストールされます。以前にuvでPythonをインストールしている場合、新しいバージョンはインストールされません。

Note

Pythonは公式の配布可能なバイナリを公開していません。そのため、uvはpython-build-standaloneプロジェクトからのサードパーティのディストリビューションを使用します。このプロジェクトは部分的にuvのメンテナによって維持されており、他の著名なPythonプロジェクト(例:RyeBazel)でも使用されています。詳細については、Pythonディストリビューションのドキュメントを参照してください。

Pythonがインストールされると、uvコマンドで自動的に使用されます。

Important

uvによってインストールされたPythonは、グローバルには利用できません(つまり、pythonコマンドでは利用できません)。この機能のサポートは将来のリリースで予定されています。それまでの間、uv runを使用するか、仮想環境を作成してアクティブ化して直接pythonを使用してください。

特定のバージョンのインストール

特定のPythonバージョンをインストールするには:

$ uv python install 3.12

複数のPythonバージョンをインストールするには:

$ uv python install 3.11 3.12

代替のPython実装(例:PyPy)をインストールするには:

$ uv python install pypy@3.10

詳細については、python installのドキュメントを参照してください。

Pythonインストールの表示

利用可能なPythonバージョンとインストール済みのPythonバージョンを表示するには:

$ uv python list

詳細については、python listのドキュメントを参照してください。

自動Pythonダウンロード

uvを使用するためにPythonを明示的にインストールする必要はありません。デフォルトでは、uvは必要に応じてPythonのバージョンを自動的にダウンロードします。例えば、次のコマンドはPython 3.12がインストールされていない場合にダウンロードします:

$ uv run --python 3.12 python -c 'print("hello world")'

特定のPythonバージョンが要求されていない場合でも、uvは必要に応じて最新バージョンをダウンロードします。例えば、次のコマンドは新しい仮想環境を作成し、Pythonが見つからない場合は管理されたPythonバージョンをダウンロードします:

$ uv venv

Tip

自動Pythonダウンロードは、Pythonのダウンロードを制御したい場合に簡単に無効にできます

既存のPythonインストールの使用

uvはシステムに存在する既存のPythonインストールを使用します。この動作には設定は必要ありません:uvはコマンドの呼び出しの要件を満たす場合にシステムPythonを使用します。詳細については、Pythonの検出のドキュメントを参照してください。

uvにシステムPythonを使用させるには、--python-preference only-systemオプションを指定します。詳細については、Pythonバージョンの優先順位のドキュメントを参照してください。

次のステップ

uv pythonの詳細については、Pythonバージョンの概念ページとコマンドリファレンスを参照してください。

または、スクリプトの実行方法を学び、uvでPythonを呼び出す方法を学んでください。