Link Search Menu Expand Document

Install OpenCV on your Raspberry Pi

Below I guide you through the basic steps necessary to get OpenCV working on the Raspberry Pi as well as on Ubuntu and Mac.

Table of contents

  1. OpenCV
  2. Install pip
  3. Install prerequisites
  4. Install OpenCV with pip
  5. Testing
  6. Installing OpenCV on Windows


OpenCV is a very extensive and incredibly powerful library for (real-time) computer vision, including object detection, motion tracking, and camera calibration.

Installing OpenCV used to be a very complicated and long process, especially on older models. Luckily it is now relatively easy to install OpenCV with pip. For more background information, see the article by Adrian Rosebrock.

Install pip

Pip is the main package manager for python that we will also use to install OpenCV. Pip should already be installed on your system (see here), but if it’s not, we can install it with wget. Open a Terminal window and enter:


Now to install pip for Python 3 enter:

sudo python3

Install prerequisites

Next, for some versions of Raspberry Pi OS we may need to install some additional packages. First make sure apt-get is fully up-to-date by entering the following in Terminal:

sudo apt-get update

Now install the prerequisites:

sudo apt-get install build-essential cmake pkg-config libjpeg-dev libtiff5-dev libjasper-dev libpng-dev libavcodec-dev libavformat-dev libswscale-dev libv4l-dev libxvidcore-dev libx264-dev libfontconfig1-dev libcairo2-dev libgdk-pixbuf2.0-dev libpango1.0-dev libgtk2.0-dev libgtk-3-dev libatlas-base-dev gfortran libhdf5-dev libhdf5-serial-dev libhdf5-103 libqtgui4 libqtwebkit4 libqt4-test python3-pyqt5 python3-dev -y

Install OpenCV with pip

Finally, we can enter install OpenCV very simply using pip. Note that if you still have python2.7 on your system and you are not working with a virtual environment with python3, you will need to type in pip3 rather than pip:

pip install opencv-contrib-python

However, before running above command, it is important to note that the latest version of OpenCV may not always be fully functional on the Raspberry Pi. Therefore I recommend to run the below command that installs the latest known working version:

pip install opencv-contrib-python==

If you still get an error message such as Could not find a version that satisfies the requirement opencv-contrib-python (from versions: ) No matching distribution found for opencv-contrib-python, try the alternative to use apt-get instead of pip:

sudo apt-get install python-opencv


Now let’s just make sure that OpenCV is working. Open a terminal window and enter python3 to start Python. Now to make sure you have installed OpenCV correctly enter:

import cv2

Your terminal window should look like:

$ python3
Python 3.7.3 (default, Dec 20 2020, 18:57:59)
[GCC 8.3.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> import cv2
>>> cv2.__version__

You are done!

Note: an alternative to getting to run the latest version of opencv on Raspberry Pi is to run the following command rather than python3: LD_PRELOAD=/usr/lib/arm-linux-gnueabihf/ python3.

Installing OpenCV on Windows

Coming soon


Add a Comment

If you use find any of the information provided on this website useful it would be great to hear from you and please consider citing the paper! All rights reserved © 2021 Jolle Jolles. Website built using Jekyll and the Just the Docs theme.