Conda環境にPython用OpenCVをインストールする方法

Conda環境にPython用OpenCVをインストールするには、pip、conda、またはAnaconda Navigatorを使います。pipでインストールするパッケージ名はopencv-pythonで、Pythonからはcv2としてインポートします。どの方法を選ぶ場合も、コードを実行する環境にインストールし、その環境でインポートを確認してください。

Conda環境でpipを使ってOpenCVをインストールする

インストール前に使用するConda環境を有効にし、pipとPythonが同じ環境を参照するようにします。その環境を有効にしたターミナルで、python -m pip install opencv-pythonを実行してください。python -m pipを使うと、その環境のPythonインタープリターを通じてpipが実行されます。このパッケージはPyPIのopencv-pythonプロジェクトから提供されています。

環境を有効にしない場合は、その環境のPython実行ファイルに-m pipを指定して実行します。別のインタープリター用にインストールされる可能性があるため、無関係なシステムのpipは使わないでください。

condaでOpenCVをインストールする

対象の環境を有効にして、conda install opencvを実行すると、Condaパッケージをインストールできます。Condaは、その環境に合わせてパッケージと依存関係を解決します。パッケージの提供状況はプラットフォームやチャンネルによって異なる場合があります。デフォルトのチャンネルでパッケージを入手できない場合は、コミュニティが管理するconda-forgeチャンネルを使い、conda install -c conda-forge opencvを実行してみてください（パッケージページ）。これは別の入手元であり、より新しいバージョンが含まれることを保証するものではありません。

Anaconda Navigatorを使ってOpenCVをインストールする

Anaconda Navigatorで、Pythonプロジェクトを実行する環境を選択します。パッケージの画面を開き、パッケージ一覧が絞り込まれている場合はAllを選び、opencvを検索します。パッケージを選択してApplyをクリックし、変更内容を確認してインストールします。Navigatorは選択した環境にインストールするため、別の環境を選ぶとcv2をインポートできるPythonインタープリターも変わります。

cv2のインストールを確認する

対象のConda環境にあるPythonインタープリターで、この確認を実行します。モジュールをインポートできればバージョンを表示し、そのインタープリターにパッケージがない場合は明確なメッセージを表示します。

import importlib.util

if importlib.util.find_spec("cv2") is None:
    print("cv2 is not installed in this Python environment.")
else:
    import cv2
    print(cv2.__version__)

cv2 is not installed in this Python environment.

提示された実行ではこの確認が実行され、cv2 is not installed in this Python environment.と表示されました。OpenCVがインストールされている環境では、バージョン行にインストール済みのOpenCVのバージョンが表示されます。パッケージがないというメッセージが表示された場合は、インストール時と同じ環境を選択または有効化しているか確認してください。インポートに成功すれば基本的な利用可能性は確認できますが、OpenCVのすべての機能が動作することや、コンピュータービジョンのプロジェクトに必要な設定が済んでいることまでは確認できません。

インストール方法を選ぶ

対象環境のインタープリターを通じてPythonパッケージをインストールしたい場合は、pipを使います。Condaにパッケージと依存関係を管理させたい場合はcondaを使い、必要に応じて代替チャンネルとしてconda-forgeを試してください。グラフィカルな画面でパッケージを管理したい場合は、Anaconda Navigatorを選べます。適した方法は、環境やパッケージの管理方法によって異なります。