【Python】OpenCV(cv2)のインストール方法(pip install)を解説

公開：2023年11月27日更新：2026年4月6日

CodeCampが提供するDX人材育成が可能なプログラミングやITが学べる公開講座

PythonでOpenCVをインストールする前の準備
OpenCVのインストール方法
インストール確認とサンプルコードの実行
特定のOSによってインストール手順が事ある
基本的な画像処理のサンプルコード

PythonでOpenCVをインストールする前の準備

OpenCVをインストールする前に、Pythonのバージョンを確認しておきましょう。

OpenCVは特定のPythonバージョンに依存する可能性があるため、正常にOpenCVがインストールされなかったら、最新のバージョンにして再度試してみてください。

# Pythonのバージョンを確認
python --version
または
python3 --version

Python研修一覧はこちら

目的に合うPython研修を一覧形式から探したい方は、ぜひご利用ください。

Python研修を比較する

Java研修一覧はこちら

目的に合うJava研修を一覧形式から探したい方は、ぜひご利用ください。

Java研修を比較する

PHP研修一覧はこちら

目的に合うPHP研修を一覧形式から探したい方は、ぜひご利用ください。

PHP研修を比較する

新入社員研修

目的に合う新入社員研修を一覧形式から探したい方は、ぜひご利用ください。

新入社員研修を比較する

全ての研修からも探したい方はこちら

OpenCVのインストール方法

OpenCVは、pipを使用してインストールします。

基本モジュールのみをインストールする場合はpip install opencv-python、拡張モジュールを含むインストールを希望する場合はpip install opencv-contrib-pythonを使用してください。

# 基本モジュールのみをインストール
pip install opencv-python

# 拡張モジュールを含むインストール
pip install opencv-contrib-python

インストール確認とサンプルコードの実行

インストール後、以下のコマンドを実行し、OpenCVが正しくインストールされたかを確認してください。

# OpenCVのバージョンを確認
import cv2
print(cv2.__version__)

# 実行結果
4.5.2

バージョンが表示されれば、インストールは成功です。

Python基礎・実践(Django)

企業・法人向けのPython研修では、基礎から応用まで体系的に学べます。

Python研修の詳細

DX社員研修

企業・法人向けのDX研修では、実務に繋がるリスキリングでITレベルを向上させます。

DX研修の詳細

Javaエンジニア育成研修

企業・法人向けのJavaエンジニア育成研修では、Javaの基礎から応用まで確実に習得できます。

Java研修の詳細

新卒・新入社員向け研修

企業・法人に新入社員・新卒社員に向けたプログラミング研修を提供しています。

新入社員研修の詳細

コードキャンプのIT研修を全て見る

特定のOSによってインストール手順が事ある

インストール手順はOSによって異なる場合があります。

WindowsやMac、Linuxでは、Pythonインタープリタの選択やpipのバージョンなどに注意する必要があります。

特にpipが古い場合は、pip install --upgrade pipでアップグレードする事をおすすめします。

基本的な画像処理のサンプルコード

OpenCVのインストールは上記の工程で完了し、以下のような事を出来るようになります。

画像の色空間変換
エッジ検出
顔認識

しかし、基本的な画像処理を最低限理解しておく必要があるので、次は「画像処理」について簡単に解説していきます。

以下は画像を読み込み表示させ、カメラからビデオをキャプチャする基本的なサンプルコードです。

# 画像を読み込む
import cv2
image = cv2.imread('example.jpg')

# 画像をウィンドウで表示
cv2.imshow('Image', image)

# キーボード入力を待つ
cv2.waitKey(0)

# ウィンドウを閉じる
cv2.destroyAllWindows()

上記のコードでは、cv2.imread()で画像を読み込み、cv2.imshow()で表示しています。

# カメラからビデオをキャプチャ
cap = cv2.VideoCapture(0)

while True:
    ret, frame = cap.read()
    cv2.imshow('Video', frame)
    if cv2.waitKey(1) & 0xFF == ord('q'):
        break

cap.release()
cv2.destroyAllWindows()

上記のコードはカメラからビデオをキャプチャし、リアルタイムで表示します。

'q'キーを押すと、停止する仕様になっています。

※上記コンテンツの内容やソースコードはAIで確認・デバッグしておりますが、間違いやエラー、脆弱性などがある場合は、コメントよりご報告いただけますと幸いです。