How to install OpenCV for python
HI! I’m trying to install opencv and use it with python, but when I compile it I get no errors but I can’t import cv module from python:
The code I used to compile it is this:
how can I get it working with python?
8 Answers 8
We can install opencv for Python for Mac OS X with home-brew.
First, install home-brew:
ruby -e «$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)»
You can see the details for how to install homebrew. http://brew.sh
If you don’t install Python, install python(brew will install python2.7):
brew install python
Maybe you want install Python3: brew install python3
Then install opencv3 for Python3:
brew install opencv3 —with-python3
If you want install opencv3 for Python(Python2.7): brew install opencv3 —with-python
OR install opencv2 for Python3: brew install opencv —with-python3
OR if you want install opencv2 for Python3: brew install opencv —with-python3
Finally, maybe you will link site-packages of opencv to the site-packages of Python.
Notes: In the follow command, /usr/local/opt/opencv3/lib/python3.5/site-packages is the directory of opencv3’s site-packages, /usr/local/lib/python3.5/site-packages/ is the directory of Python3.5’s site-packages.
Maybe you should change the two to your own OPENCV AND PYTHON site-packages directories.
echo /usr/local/opt/opencv3/lib/python3.5/site-packages >> /usr/local/lib/python3.5/site-packages/opencv3.pth
macOS: Install OpenCV 3 and Python 3.5
by Adrian Rosebrock on December 5, 2016
In today’s tutorial we’ll learn how to install OpenCV 3 with Python 3.5 bindings on macOS.
I decided to break these install tutorials into two separate guides to keep them well organized and easy to follow.
To learn how to install OpenCV 3 with Python 3.5 bindings on your macOS system, just keep reading.
macOS: Install OpenCV 3 and Python 3.5
As I mentioned in the introduction to this post, I spent last week covering how to install OpenCV 3 with Python 2.7 bindings on macOS.
Many of the steps in last week’s tutorial and today’s tutorial are very similar (and in some cases identical) so I’ve tried to trim down some of the explanations for each step to reduce redundancy. If you find any step confusing or troublesome I would suggest referring to the OpenCV 3 + Python 2.7 tutorial where I have provided more insight.
The exception to this is “Step #7: Configure OpenCV 3 and Python 3.5 via CMake on macOS” where I provide an extremely thorough walkthrough on how to configure your OpenCV build. You should pay extra special attention to this step to ensure your OpenCV build has been configured correctly.
With all that said, let’s go ahead and install OpenCV 3 with Python 3.5 bindings on macOS.
Step #1: Install Xcode
Before we can compile OpenCV on our system, we first need to install Xcode, Apple’s set of software development tools for the Mac Operating System.
The easiest method to download Xcode is to open up the App Store application on your desktop, search for “Xcode” in the search bar, and then click the “Get” button:
Figure 1: Downloading and installing Xcode on macOS.
After installing Xcode you’ll want to open up a terminal and ensure you have accepted the developer license:
We also need to install the Apple Command Line Tools. These tools include programs and libraries such as GCC, make, clang, etc. You can use the following command to install the Apple Command Line Tools:
When executing the above command a confirmation window will pop up asking for you to confirm the install:
Figure 2: Installing the Apple Command Line Tools on macOS.
Click the “Install” button to continue. The actual installation process should take less than 5 minutes to complete.
Step #2: Install Homebrew
The next step is to install Homebrew, a package manager for macOS. You can think of Homebrew as the macOS equivalent of Ubuntu/Debian-based apt-get.
Installing Homebrew itself is super easy, just copy and paste the entire command below:
Once Homebrew is installed you should make sure the package definitions are up to date by running:
We now need to update our
/.bash_profile file (or create it if it doesn’t exist already). Open up the file using your favorite text editor (I’m using nano in this case):
And then add the following lines to the file:
This export command simply updates the PATH variable to look for binaries/libraries along the Homebrew path before the system path is consulted.
I have included a screenshot of what my
/.bash_profile looks like as reference below:
Figure 3: Updating my .bash_profile file to include Homebrew.
After updating your .bash_profile file, save and exitor the editor followed by using source to ensure the changes to the .bash_profile are manually reloaded:
This command only needs to be executed once. Anytime you open up a new terminal your .bash_profile will automatically be source ‘d for you.
Step #3: Setup Homebrew for Python 3.5 and macOS
It is considered bad form to develop against the system Python as your main interpreter. The system version of Python should serve only one purpose — support system routines and operations. There is also the fact that macOS does not ship with Python 3 out of the box.
Instead, you should install your own version of Python that is independent from the system install. Using Homebrew, we can install Python 3 using the following command:
Note: Make sure you don’t forget the “3” in “python3”. The above command will install Python 3.5 on your system. However, if you leave off the “3” you’ll end up installing Python 2.7.
As a sanity check, it’s important to confirm that you are using the Homebrew version of Python 3 rather than the system version of Python 3. To accomplish this, simply use the which command:
Important: Inspect this output closely. If you see /usr/local/bin/python3 then you are correctly using the Homebrew version of Python. However, if the output is /usr/bin/python3 then you are incorrectly using the system version of Python.
If you find yourself using the system version of Python instead of the Homebrew version you should:
- Ensure Homebrew installed without error.
- Check that brew install python3 finished successfully.
- You have properly updated your
/.bash_profile and reloaded the changes using source . This basically boils down to making sure your
/.bash_profile looks like mine above in Figure 3.
Step #4: Install Python virtual environments and NumPy
We’ve made good progress so far. We’ve installed a non-system version of Python 3 via Homebrew. However, let’s not stop there. Let’s install both virtualenv and virtualenvwrapper so we can create separate, independent Python environments for each project we are working on — this is considered a best practice when developing software in the Python programming language.
I’ve already discussed Python virtual environments ad nauseam in previous blog posts, so if you’re curious about how they work and why we use them, please refer to the first half of this blog post. I also highly recommend reading through this excellent tutorial on the RealPython.com blog that takes a deeper dive into Python virtual environments.
Install virtualenv and virtualenvwrapper
Installing both virtualenv and virtualenvwrapper is a snap using pip :
After these packages have been installed we need to update our
Once opened, append the following lines to the file:
After updating, your
/.bash_profile should look similar to mine:
Figure 4: Updating your .bash_profile file to include virtualenv/virtualenvwrapper.
After updating your .bash_profile , save it, exit, and then once again source it:
I’ll reiterate that this command only needs to be executed once. Each time you open up a new terminal window this file will automatically be source ‘d for you.
Create your Python 3 virtual environment
We can now use the mkvirtualenv command to create a Python 3 virtual environment named cv :
The -p python3 switch ensures that a Python 3 virtual environment is created instead of a Python 2.7 one.
Again, the above command will create a Python environment named cv that is independent from all other Python environments on your system. This environment will have it’s own site-packages directory, etc., allowing you to avoid any type of library versioning issues across projects.
The mkvirtualenv command only needs to be executed once. To access the cv Python virtual environment after it has been created, just use the workon command:
To validate that you are in the cv virtual environment, just examine your command line. If you see the text (cv) preceding the prompt, then you are are in the cv virtual environment:
Figure 5: Make sure you see the “(cv)” text on your prompt, indicating that you are in the cv virtual environment.
Otherwise, if you do not see the cv text, then you are not in the cv virtual environment:
Figure 6: If you do not see the “(cv)” text on your prompt, then you are not in the cv virtual environment and you need to run the “workon” command to resolve this issue before continuing.
If you find yourself in this situation all you need to do is utilize the workon command mentioned above.
Install NumPy
The only Python-based prerequisite that OpenCV needs is NumPy, a scientific computing package.
To install NumPy into our cv virtual environment, ensure you are in the cv environment (otherwise NumPy will be installed into the system version of Python) and then utilize pip to handle the actual installation:
Step #5: Install OpenCV prerequisites using Homebrew
OpenCV requires a few prerequisites to be installed before we compile it. These packages are related to either (1) tools used to build and compile, (2) libraries used for image I/O operations (i.e., loading various image file formats from disk such as JPEG, PNG, TIFF, etc.) or (3) optimization libraries.
To install these prerequisites for OpenCV on macOS execute the following commands:
Step #6: Download the OpenCV 3 source from GitHub
As I detailed in last week’s tutorial, OpenCV 3 on macOS needs to be compiled via the latest commit to GitHub instead of an actual tagged release (i.e., 3.0, 3.1, etc.). This is because the current tagged releases of OpenCV do not provide fixes for the QTKit vs. AVFoundation errors (please see last week’s blog post for a thorough discussion on this).
First, we need to download the OpenCV GitHub repo:
Step #7: Configure OpenCV and Python 3.5 via CMake on macOS
This section of the tutorial is the most challenging and the one that you’ll want to pay the most attention to.
First, I’ll demonstrate how to setup your build by creating the a build directory.
I then provide a CMake template that you can use to start the process of compiling OpenCV 3 with Python 3.5 bindings on macOS. This template requires you to fill in two values:
- The path to your libpython3.5.dylib file.
- The path to your Python.h headers for Python 3.5.
I will help you find and determine the correct values for these paths.
Finally, I provide a fully completed CMake command as an example. Please note that is command is specific to my machine. Your CMake command may be slightly different due to the paths specified. Please read the rest of this section for details.
Setting up the build
In order to compile OpenCV with Python 3.5 bindings for macOS we first need to set up the build. This simply amounts to changing directories and creating a build directory:
OpenCV 3 + Python 3.5 CMake template for macOS
The next part, where we configure our actual build, gets a little tricky. In order to make this process easier I have constructed the following OpenCV 3 + Python 3.5 CMake template:
Looking at this template I want to point out a few things to you:
- BUILD_opencv_python2=OFF : This switch indicates that we do not want to build Python 2.7 bindings. This needs to be explicity stated in the CMake command. Failure to do this can cause problems when we actually run CMake.
- BUILD_opencv_python3=ON : We would like for OpenCV 3 + Python 3.5 bindings to be built. This instruction indicates to CMake that the Python 3.5 binding should be built rather than Python 2.7.
- PYTHON3_LIBRARY=YYY : This is the first value that you need to fill in yourself. You need to replace YYY with the path to your libpython3.5.dylib file. I will hep you find the path to this value in the next section.
- PYTHON3_INCLUDE_DIR=ZZZ : This is the second value that you need to fill in. You will need to replace ZZZ with the path to your Python.h headers. Again, I will help you determine this path.
Determining your Python 3.5 library and include directory
We will start by configuring your PYTHON3_LIBRARY value. This switch should point to your libpython3.5.dylib file. This file is located within many nested subdirectories of /usr/local/Cellar/python . To find the exact path to the libpython3.5.dylib file, just use the ls command with a wildcard (auto-tab complete also works as well):
Take note of the output of this command — this is the full path to your libpython3.5.dylib file and will replace YYY in the CMake template above.
Let’s move along to determining the PYTHON3_INCLUDE_DIR variable. This path should point to the Python.h header files for Python 3.5 used to generate the actual OpenCV 3 + Python 3.5 bindings.
Again, we’ll use the same ls and wildcard trick here to determine the proper path:
The output of the ls -d command is our full path to the Python.h headers. This value will replace ZZZ in the CMake template.
Filling in the CMake template
Now that we’ve determined the PYTHON3_LIBRARY and PYTHON3_INCLUDE_DIR values we need to update the CMake command to reflect these paths.
On my machine, the full CMake command to configure my OpenCV 3 + Python 3.5 build looks like:
However, please do not copy and paste my exact CMake command — make sure you have used the instructions above to properly determine your PYTHON3_LIBRARY and PYTHON3_INCLUDE_DIR values.
Once you’ve filled in these values, execute your cmake command and your OpenCV 3 + Python 3.5 build will be configured.
As an example, take a look at the Python 3 section output from my configuration:
Figure 7: Ensuring that Python 3.5 will be used when compiling OpenCV 3 for macOS.
In particular, you’ll want to make sure that:
- The Interpreter points to the Python binary in your cv virtual environment.
- Libraries points to your libpython3.5.dylib file.
- The numpy version being utilized is the one you installed in your cv virtual environment.
Step #8: Compile and install OpenCV 3 on macOS
After investigating your cmake command and ensuring it exited without error (and that the Python 3 section was properly configured), you can now compile OpenCV:
In this case, I am supplying -j4 to compile OpenCV using all four cores on my machine. You can tune this value based on the number of processors/cores you have.
OpenCV can take awhile to compile, anywhere from 30-90 minutes, depending on your system specs. I would consider going for a nice long walk while it compiles.
A successful compile will end with a 100% completion:
Figure 8: Successfully compiling OpenCV 3 from source with Python 3.5 bindings on macOS.
Assuming that OpenCV compiled without error, you can now install it on your macOS system:
Step #9: Rename and sym-link your OpenCV 3 + Python 3.5 bindings
After running sudo make install your OpenCV 3 + Python 3.5 bindings should be located in /usr/local/lib/python3.5/site-packages . You can verify this by using the ls command:
I’ve been perplexed by this behavior ever since OpenCV 3 was released, but for some reason, when compiling OpenCV with Python 3 support enabled the output cv2.so bindings are named differently. The actual filename will vary a bit depending on your system architecture, but it should look something like cv2.cpython-35m-darwin.so .
Again, I don’t know exactly why this happens, but it’s an easy fix. All we need to do is rename the file to cv2.so :
After renaming cv2.cpython-35m-darwin.so to cv2.so we then need to sym-link our OpenCV bindings into the cv virtual environment for Python 3.5:
Step #10: Verify your OpenCV 3 install on macOS
To verify that your OpenCV 3 + Python 3.5 installation on macOS is working you should:
- Open up a new terminal.
- Execute the workon command to access the cv Python virtual environment.
- Attempt to import the Python + OpenCV bindings.
Here are the exact steps you can use to test the install:
Note: Take note of the -dev in the cv2.__version__ . This indicates that we are using the development version of OpenCV and not a tagged release. Once OpenCV 3.2 is released these instructions can be updated to simply download a .zip of the tagged version rather than having to clone down the entire repositories.
I’ve also included a screenshot below that utilizes these same steps. As you can see, I can access my OpenCV 3 bindings from Python 3.5 shell:
Figure 9: Ensuring that I have successfully installed my OpenCV 3 + Python 3.5 bindings on macOS.
Congratulations, you have installed OpenCV with Python 3.5 bindings on your macOS system!
So, what’s next?
Congrats! You now have a brand new, fresh install of OpenCV on your macOS system — and I’m sure you’re just itching to leverage your install to build some awesome computer vision apps…
…but I’m also willing to bet that you’re just getting started learning computer vision and OpenCV, and probably feeling a bit confused and overwhelmed on exactly where to start.
Personally, I’m a big fan of learning by example, so a good first step would be to have some fun and read this blog post on detecting cats in images/videos. This tutorial is meant to be very hands-on and demonstrate how you can (quickly) build a Python + OpenCV application to detect the presence of cats in images.
And if you’re really interested in leveling-up your computer vision skills, you should definitely check out my book, Practical Python and OpenCV + Case Studies. My book not only covers the basics of computer vision and image processing, but also teaches you how to solve real-world computer vision problems including face detection in images and video streams, object tracking in video, and handwriting recognition.
Summary
In this tutorial you learned how to compile and install OpenCV 3 with Python 3.5 bindings on macOS Sierra.
To accomplish this, we configured and compiled OpenCV 3 by hand using the CMake utility. While this isn’t exactly the most “fun” experience, it does give us complete and total control over the install.
If you’re looking for an easier way to get OpenCV installed on your Mac system be sure to stay tuned for next week’s blog post where I demonstrate how to install OpenCV on macOS using nothing but Homebrew.
To be notified when this blog post goes live, please enter your email address in the form below and I’ll be sure to ping you when the tutorial is published.
Join the PyImageSearch Newsletter and Grab My FREE 17-page Resource Guide PDF
Enter your email address below to join the PyImageSearch Newsletter and download my FREE 17-page Resource Guide PDF on Computer Vision, OpenCV, and Deep Learning.
About the Author
Hi there, I’m Adrian Rosebrock, PhD. All too often I see developers, students, and researchers wasting their time, studying the wrong things, and generally struggling to get started with Computer Vision, Deep Learning, and OpenCV. I created this website to show you what I believe is the best possible way to get your start.
Reader Interactions
macOS: Install OpenCV 3 and Python 2.7
Install OpenCV 3 on macOS with Homebrew (the easy way)
222 responses to: macOS: Install OpenCV 3 and Python 3.5
Hi adrian,
I have a question regarding using c++ opencv. Are we supposed to have a separate virtual environment for that? What is the proper technique for installing and using c++ opencv on mac os Sierra? -the cake commands etc, as well as how to compile the c++ code for opencv. Do you think you could do a tutorial on that? Currently I’m just using c++ opencv on a virtual environment created from the python 2 tutorial and it works but I am not sure that I’m doing things correctly by using a python virtual environment for c++.
C++ doesn’t have a concept of a virtual environment in the same context as Python. This guide demonstrates how to use Python with OpenCV bindings, but natively OpenCV is a C++ library. You simply compile it, install it, and then use gcc/g++ to link against it when compiling your C++ code.
hello sir, i followed your steps until i update the .bash_profile after installing virtualenv .
before when i used the line pip install virtualenv virtualenvwrapper it didn’t worked as its saying some exceptions . but however i installed by using pip install –user virtualenv virtualenvwrapper.
now when i source the ,bash_profile i get -bash: /usr/local/bin/virtualenvwrapper.sh: No such file or directory .
and also whenever i quit the terminal and reopen it i get the above line in the 2nd line.
The reason you are getting the error each time you open a new terminal is because the
/.bash_profile file is automatically loaded. Since virtualenv and virtualenvwrapper are not properly configured you are receiving the error.
Which version of Python (2.7 or 3) are you installing OpenCV for?