Installing Python#
Pythonがすでにシステムにインストールされている場合、uvは設定なしでdetect and useします。ただし、uvはPythonのバージョンをインストールして管理することもできます。
Tip
uvは必要に応じてautomatically fetch Python versionsします。開始するためにPythonをインストールする必要はありません。
Getting started#
最新バージョンのPythonをインストールするには:
これにより、システムにすでにPythonがインストールされている場合でも、uv管理されたPythonバージョンがインストールされます。以前にuvを使用してPythonをインストールした場合、新しいバージョンはインストールされません。
Note
Pythonは公式に配布可能なバイナリを公開していません。そのため、uvはpython-build-standaloneプロジェクトのサードパーティディストリビューションを使用しています。このプロジェクトは部分的にuvメンテナによって維持されており、他の著名なPythonプロジェクト(Rye、Bazelなど)によって使用されています。詳細については、Python distributionsのドキュメントを参照してください。
-->
Pythonがインストールされると、自動的にuvコマンドによって使用されます。
Important
Pythonがuvによってインストールされた場合、グローバルに(つまりpythonコマンドを介して)使用することはできません。この機能のサポートは将来のリリースで予定されています。その間、pythonを直接使用するには、uv runまたはcreate and activate a virtual environmentを使用してください。
Installing a specific version#
特定のPythonバージョンをインストールするには:
複数のPythonバージョンをインストールするには:
別のPython実装、たとえばPyPyをインストールするには、次のようにします。
詳細については、python installのドキュメントを参照してください。
Viewing Python installations#
使用可能なPythonバージョンとインストール済みのPythonバージョンを表示するには:
詳細については、python listのドキュメントを参照してください。
Automatic Python downloads#
uvを使用するためにPythonを明示的にインストールする必要はないことに注意してください。デフォルトでは、uvは必要に応じてPythonバージョンを自動的にダウンロードします。たとえば、次の例では、Python 3.12がインストールされていない場合はダウンロードされます。
特定のPythonバージョンが要求されていない場合でも、uvは必要に応じて最新バージョンをダウンロードします。たとえば、次の例では、新しい仮想環境を作成し、Pythonが見つからない場合は管理されたPythonバージョンをダウンロードします。
Tip
Pythonのダウンロードをより詳細に制御する場合は、Pythonの自動ダウンロードを[easily disabled]ことができます(../concepts/python-versions.md#disabling-automatic-python-downloads)。
-->
Using an existing Python installation#
uvは、システムに存在する場合、既存のPythonインストールを使用します。この動作に必要な設定はありません。uvは、コマンド呼び出しの要件を満たす場合、システムPythonを使用します。Python discoveryのドキュメントを参照してください。
uvに強制的にシステムPythonを使用させるには、--python-preference only-systemオプションを指定します。詳細については、Python version preferenceのドキュメントを参照してください。
Next steps#
uv pythonの詳細については、Python version conceptページとcommand referenceを参照してください。
または、scriptsを実行し、uvを使用してPythonを呼び出す方法についても説明します。