Introduction

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. 

Tutorial on how to install NumPy.

Prerequisites

  • Access to a terminal window/command line
  • A user account with sudo privileges
  • Python installed on your system

Installing NumPy

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:

python -V

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:

python3 -V

In the example below, you can see both versions of Python are present.

Verifying Python version on an Ubuntu system.

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.

Commands for checking Pip version.

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.

Install NumPy with Python 2.

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.

The command for installing NumPy with Python 3.


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

Use the 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:

python
python3

Once you are in the python or python3 prompt you can import the new package and add an alias for it (in the example below it is np):

import numpy as np

Upgrading NumPy

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

Conclusion

By following this guide, you should have successfully installed NumPy on your system.

For more Python package tutorials, check out the related KB articles.


Next you should also read