インストール

通常、pip は以下の場合に自動的にインストールされます。

  • 仮想環境で作業している場合

  • python.org からダウンロードした Python を使用している場合

  • 再配布業者によって ensurepip を削除するように変更されていない Python を使用している場合

サポートされている方法

Python 環境に pip がインストールされていない場合、pip のメンテナによって直接サポートされている pip をインストールする方法は 2 つあります。

ensurepip

Python には ensurepip モジュール[1]が付属しており、Python 環境に pip をインストールできます。

$ python -m ensurepip --upgrade
$ python -m ensurepip --upgrade
C:> py -m ensurepip --upgrade

ensurepip の仕組みと使用方法の詳細については、標準ライブラリのドキュメントを参照してください。

get-pip.py

これは、ブートストラップロジックを使用して pip をインストールする Python スクリプトです。

  • https://bootstrap.pypa.io/get-pip.py からスクリプトをダウンロードします。

  • ターミナル/コマンドプロンプトを開き、get-pip.py ファイルがあるフォルダに cd で移動し、以下を実行します。

    $ python get-pip.py
    
    $ python get-pip.py
    
    C:> py get-pip.py
    

このスクリプトの詳細については、pypa/get-pip の README を参照してください。

スタンドアロン zip アプリケーション

注記

zip アプリケーションは現在実験段階です。pip がこの形式で正しく動作することをテストしていますが、状況によっては問題が発生する可能性があります。そのような場合はバグレポートを受け付けますが、現時点では zip アプリケーションを本番環境で使用しないでください。

pip を環境にインストールすることに加えて、pip はスタンドアロンの zip アプリケーション として利用できます。これは https://bootstrap.pypa.io/pip/pip.pyz からダウンロードできます。pip-X.Y.Z.pyz という名前の特定の pip バージョンの zip アプリケーションもあります。

zip アプリケーションは、サポートされている任意のバージョンの Python を使用して実行できます。

$ python pip.pyz --help
$ python pip.pyz --help
C:> py pip.pyz --help

直接実行する場合

$ chmod +x ./pip.pyz
$ ./pip.pyz

現在アクティブな Python インタプリタが使用されます。

$ chmod +x ./pip.pyz
$ ./pip.pyz

現在アクティブな Python インタプリタが使用されます。

C:> .\pip.pyz

現在アクティブな Python インタプリタが使用されます。

これが機能するには、システムで .pyz 拡張子を認識するように設定する必要がある場合があります。

代替方法

Python のインストール方法によっては、Linux パッケージマネージャーの使用など、pip をインストールするための他のメカニズムが利用できる場合があります。

これらのメカニズムは、pip の再配布業者によって提供されており、pip の動作を変更するために pip を変更している可能性があります。これは、このドキュメントに記載されている動作と、変更後の pip の動作との間に不一致が生じるため、ユーザーの混乱を招く原因となっています。

これらのメカニズムを使用してインストールされた Python と pip を使用しているときに問題が発生した場合は、関連するプロバイダー (Linux ディストリビューションコミュニティ、クラウドプロバイダーのサポートチャネルなど) にサポートを依頼することをお勧めします。

pip のアップグレード

以下を実行して pip をアップグレードします。

$ python -m pip install --upgrade pip
$ python -m pip install --upgrade pip
C:> py -m pip install --upgrade pip

互換性

現在のバージョンの pip は以下で動作します。

  • Windows、Linux、macOS。

  • CPython 3.8、3.9、3.10、3.11、3.12、および最新の PyPy3。

pip は、上記にリストされている各マイナーバージョンの Python インタプリタの最新パッチバージョンで動作するようにテストされています。以前のパッチバージョンは、ベストエフォート方式でサポートされています。

その他のオペレーティングシステムと Python バージョンは、pip のメンテナによってサポートされていません。

サポートされていないプラットフォームを使用しているユーザーは、問題が発生した場合、自分で解決する必要があることに注意してください。プラットフォームのサポートを提供するソースから pip を受け取った場合は、そのソースから pip のサポートをリクエストする必要があります。