Pythonのインストール
Pythonがすでにシステムにインストールされている場合、uvは設定なしでそれを検出して使用します。ただし、uvはPythonのバージョンをインストールおよび管理することもできます。
Tip
uvは必要に応じて自動的にPythonのバージョンを取得します。Pythonをインストールする必要はありません。
はじめに
最新のPythonバージョンをインストールするには:
これにより、システムにPythonがすでにインストールされている場合でも、uv管理のPythonバージョンがインストールされます。以前にuvでPythonをインストールしている場合、新しいバージョンはインストールされません。
Note
Pythonは公式の配布可能なバイナリを公開していません。そのため、uvはpython-build-standalone
プロジェクトからのサードパーティのディストリビューションを使用します。このプロジェクトは部分的にuvのメンテナによって維持されており、他の著名なPythonプロジェクト(例:Rye、Bazel)でも使用されています。詳細については、Pythonディストリビューションのドキュメントを参照してください。
Pythonがインストールされると、uv
コマンドで自動的に使用されます。
Important
uvによってインストールされたPythonは、グローバルには利用できません(つまり、python
コマンドでは利用できません)。この機能のサポートは将来のリリースで予定されています。それまでの間、uv run
を使用するか、仮想環境を作成してアクティブ化して直接python
を使用してください。
特定のバージョンのインストール
特定のPythonバージョンをインストールするには:
複数のPythonバージョンをインストールするには:
代替のPython実装(例:PyPy)をインストールするには:
詳細については、python install
のドキュメントを参照してください。
Pythonインストールの表示
利用可能なPythonバージョンとインストール済みのPythonバージョンを表示するには:
詳細については、python list
のドキュメントを参照してください。
自動Pythonダウンロード
uvを使用するためにPythonを明示的にインストールする必要はありません。デフォルトでは、uvは必要に応じてPythonのバージョンを自動的にダウンロードします。例えば、次のコマンドはPython 3.12がインストールされていない場合にダウンロードします:
特定のPythonバージョンが要求されていない場合でも、uvは必要に応じて最新バージョンをダウンロードします。例えば、次のコマンドは新しい仮想環境を作成し、Pythonが見つからない場合は管理されたPythonバージョンをダウンロードします:
Tip
自動Pythonダウンロードは、Pythonのダウンロードを制御したい場合に簡単に無効にできます。
既存のPythonインストールの使用
uvはシステムに存在する既存のPythonインストールを使用します。この動作には設定は必要ありません:uvはコマンドの呼び出しの要件を満たす場合にシステムPythonを使用します。詳細については、Pythonの検出のドキュメントを参照してください。
uvにシステムPythonを使用させるには、--python-preference only-system
オプションを指定します。詳細については、Pythonバージョンの優先順位のドキュメントを参照してください。
次のステップ
uv python
の詳細については、Pythonバージョンの概念ページとコマンドリファレンスを参照してください。
または、スクリプトの実行方法を学び、uvでPythonを呼び出す方法を学んでください。