NumPy (Numerical Python) is an open-source library for the Python programming language. It is used for scientific computing and working with arrays.
Apart from its multidimensional array object, it also provides high-level functioning tools for working with arrays.
In this tutorial, you will learn how to install NumPy.
- Access to a terminal window/command line
- A user account with sudo privileges
- Python installed on your system
You can follow the steps outlined below and use the commands on most Linux, Mac, or Windows systems. Any irregularities in commands are noted along with instructions on how to modify them to your needs.
Step 1: Check Python Version
Before you can install NumPy, you need to know which Python version you have. This programming language comes preinstalled on most operating systems (except Windows; you will need to install Python on Windows manually).
Most likely, you have Python 2 or Python 3 installed, or even both versions.
To check whether you have Python 2, run the command:
The output should give you a version number.
To see if you have Python 3 on your system, enter the following in the terminal window:
In the example below, you can see both versions of Python are present.
If these commands do not work on your system, take a look at this article on How To Check Python Version In Linux, Mac, & Windows.
Note: If you need help installing a newer version of Python, refer to one of our installation guides – How to Install Python on CentOS 8, How to Install Python 3.7 on Ubuntu, or How to Install Python 3 on Windows.
Step 2: Install Pip
The easiest way to install NumPy is by using Pip. Pip a package manager for installing and managing Python software packages.
Unlike Python, Pip does not come preinstalled on most operating systems. Therefore, you need to set up the package manager that corresponds to the version of Python you have. If you have both versions of Python, install both Pip versions as well.
The commands below use the
apt utility as we are installing on Ubuntu for the purposes of this article.
Install Pip (for Python 2) by running:
sudo apt install python-pip
If you need Pip for Python 3, use the command:
sudo apt install python3-pip
Important: Depending on the operating system you are using, follow the instructions in one of our Pip installation guides:
Finally, verify you have successfully installed Pip by typing
pip -V and/or
pip3 -V in the terminal window.
Step 3: Install NumPy
With Pip set up, you can use its command line for installing NumPy.
Install NumPy with Python 2 by typing:
pip install numpy
Pip downloads the NumPy package and notifies you it has been successfully installed.
To install NumPy with the package manager for Python 3, run:
pip3 install numpy
As this is a newer version of Python, the Numpy version also differs as you can see in the image below.
Note: The commands are the same for all operating systems except for Fedora. If you are working on this OS, the command to install NumPy with Python 3 is:
python3 -m pip install numpy.
Step 4: Verify NumPy Installation
show command to verify whether NumPy is now part of you Python packages:
pip show numpy
And for Pip3 type:
pip3 show numpy
The output should confirm you have NumPy, which version you are using, as well as where the package is stored.
Step 5: Import the NumPy Package
After installing NumPy you can import the package and set an alias for it.
To do so, move to the
python prompt by typing one of the following commands:
Once you are in the
python3 prompt you can import the new package and add an alias for it (in the example below it is
import numpy as np
If you already have NumPy and want to upgrade to the latest version, for Pip2 use the command:
pip install --upgrade numpy
If using Pip3, run the following command:
pip3 install --upgrade numpy
By following this guide, you should have successfully installed NumPy on your system.
Check out our introduction tutorial on Python Pandas, an open-source Python library primarily used for data analysis, which is built on top of the NumPy package and is compatible with a wide array of existing modules. The collection of tools in the Pandas package is an essential resource for preparing, transforming, and aggregating data in Python.
For more Python package tutorials, check out our other KB articles such as Best Python IDEs and more!