ModuleNotFoundError: No module named 'numpy' in Python

Borislav Hadzhiev

Last updated: Apr 8, 2024

Reading timeยท12 min

**The Python "ModuleNotFoundError: No module named 'numpy'" occurs when we
forget to install the numpy module before importing it or install it in an
incorrect environment.**

**To solve the error, install the module by running the pip install numpy
command.**

Open your terminal in your project's root directory and install the `numpy`

module.

shell

`# ๐๏ธ In a virtual environment or using Python 2 pip install numpy # ๐๏ธ For Python 3 (could also be pip3.10 depending on your version) pip3 install numpy # ๐๏ธ If you get a permissions error sudo pip3 install numpy pip install numpy --user # ๐๏ธ If you don't have pip in your PATH environment variable python -m pip install numpy # ๐๏ธ For Python 3 (could also be pip3.10 depending on your version) python3 -m pip install numpy # ๐๏ธ Using py alias (Windows) py -m pip install numpy # ๐๏ธ For Anaconda conda install -c anaconda numpy # ๐๏ธ For Jupyter Notebook !pip install numpy`

After you install the numpy package, try importing it as follows.

main.py

`import numpy as np a = np.arange(6) a2 = a[np.newaxis, :] print(a2.shape)`

The error occurs for multiple reasons:

- Not having the
`numpy`

package installed by running`pip install numpy`

. - Installing the package in a different Python version than the one you're using.
- Installing the package globally and not in your virtual environment.
- Your IDE running an incorrect version of Python.
- Naming your module
`numpy.py`

which would shadow the official module. - Declaring a variable named
`numpy`

which would shadow the imported variable.

If the error persists, get your Python version and make sure you are installing the package using the correct Python version.

shell

`python --version`

For example, my Python version is `3.10.4`

, so I would install the `numpy`

package with `pip3.10 install numpy`

.

shell

`pip3.10 install numpy # ๐๏ธ If you get a permissions error use pip3 (NOT pip3.X) sudo pip3 install numpy`

Notice that the version number corresponds to the version of `pip`

I'm using.

If the PATH for `pip`

is not set up on your machine, replace `pip`

with
`python3 -m pip`

:

shell

`# ๐๏ธ Make sure to use your version of Python, e.g. 3.10 python3 -m pip install numpy`

If the error persists, try restarting your IDE and development server/script.

You can
check if you have the `numpy`

package installed
by running the `pip show numpy`

command.

shell

`# ๐๏ธ Check if you have `numpy` installed pip show numpy # ๐๏ธ If you don't have pip set up in PATH python -m pip show numpy`

The `pip show numpy`

command will either state that the package is not installed
or show a bunch of information about the package, including the location where
the package is installed.

If the package is not installed, make sure your IDE is using the correct version of Python.

If you have multiple Python versions installed on your machine, you might have installed the

`numpy`

package using the incorrect version or your IDE might be set up to use a different version.For example, In VSCode, you can press `CTRL + Shift + P`

or (`โ`

+ `Shift`

+ `P`

on Mac) to open the command palette.

Then type "Python select interpreter" in the field.

Then Select the correct Python version from the dropdown menu.

Your IDE should be using the same version of Python (including the virtual environment) that you are using to install packages from your terminal.

If you are using a virtual environment, make sure you are installing `numpy`

in
your virtual environment and not globally.

You can try creating a virtual environment if you don't already have one.

shell

`# ๐๏ธ Use the correct version of Python when creating VENV python3 -m venv venv # ๐๏ธ Activate on Unix or MacOS source venv/bin/activate # ๐๏ธ Activate on Windows (cmd.exe) venv\Scripts\activate.bat # ๐๏ธ Activate on Windows (PowerShell) venv\Scripts\Activate.ps1 # ๐๏ธ Install `numpy` in your virtual environment pip install numpy`

If the `python3 -m venv venv`

command doesn't work, try the following 2
commands:

`python -m venv venv`

`py -m venv venv`

Your virtual environment will use the version of Python that was used to create it.

If the error persists, make sure you haven't named a module in your project as

`numpy.py`

because that would shadow the original `numpy`

module.You also shouldn't be declaring a variable named `numpy`

as that would also
shadow the original module.

If the error is not resolved, try to uninstall the `numpy`

package and then
reinstall it.

shell

`# ๐๏ธ Check if you have `numpy` installed pip show numpy # ๐๏ธ If you don't have pip set up in PATH python -m pip show numpy # ๐๏ธ Uninstall numpy pip uninstall numpy # ๐๏ธ If you don't have pip set up in PATH python -m pip uninstall numpy # ๐๏ธ Install `numpy` pip install numpy # ๐๏ธ If you don't have pip set up in PATH python -m pip install numpy`

Try restarting your IDE and development server/script.

You can also try to upgrade the version of the `numpy`

package.

shell

`pip install numpy --upgrade # ๐๏ธ If you don't have pip set up in PATH python -m pip install numpy --upgrade`

**The error "Import "numpy" could not be resolved from source Pylance" occurs
when the numpy module is not installed or you have selected the incorrect
Python interpreter in your IDE (e.g. Visual Studio Code).**

To solve the error, install `numpy`

and select the correct Python interpreter in
your IDE.

shell

`Import "numpy" could not be resolved from source Pylance(reportMissingModuleSource) [Ln 1, Col 8]`

If you have multiple Python versions installed on your machine, you might have
installed the `numpy`

package using the incorrect version or your IDE might be
set up to use a different version.

For example, In Visual Studio Code you can:

- Press
`CTRL + Shift + P`

or (`โ`

+`Shift`

+`P`

on macOS) to open the command palette.

Then type **"Python select interpreter"** in the search field.

- Select the correct Python version from the dropdown menu.

Your IDE should be using the same version of Python (including the virtual environment) that you are using to install packages from your terminal.

If the error persists, try restarting your IDE and development server/script. VSCode often glitches and a reboot resolves the issue.

If the error is not resolved, try to use the Visual Studio Code terminal to
install the `numpy`

module.

**You can press CTRL + ` (Backtick) on your keyboard to open the Visual Studio
code terminal.**

You can also open the terminal in Visual Studio Code by pressing

`CTRL+Shift+P`

and then type "View: Toggle Terminal".Once you open the terminal, Visual Studio Code will automatically activate your virtual environment (if you have one).

Run the `pip install numpy`

command.

shell

`pip install numpy`

**If the error persists, try to select the Python interpreter by specifying the
path:**

- Press
`CTRL + Shift + P`

or (`โ`

+`Shift`

+`P`

on Mac) to open the command palette. - Type
**"Python select interpreter"**in the field.

- Select
**"Enter interpreter path..."**.

- Click on
**"Find"**.

- In the window that opens, navigate to your Python executable:

- If you have a virtual environment on Windows, click on your
`venv`

folder, then double-click on the`Scripts`

folder, select the`python.exe`

file and then**Select interpreter**.

- If you have a virtual environment on macOS or Linux, click on your
`venv`

folder, then double-click on the`bin`

folder, select the`python`

file and then**Select interpreter**.

- If you don't have a virtual environment, use one of the following commands to
get your path to your
`python.exe`

or`python`

executable, specify the path to the file and select the executable.

cmd

`where python python -c "import sys; print(sys.executable)"`

If the error persists, try restarting your IDE and development server/script.

If none of the suggestions helped, you can use a comment to disable the Pylance warning in your IDE.

main.py

`import numpy # type: ignore print(numpy)`

You simply have to add the `# type: ignore`

command on the same line as the
import statement to disable the check for the specific import.

If the error persists, follow the operating system-specific instructions on how to install

`numpy`

.- Install numpy on Windows
- Install numpy on macOS or Linux
- Install numpy in Visual Studio Code
- Install numpy in PyCharm
- Install numpy in Anaconda
- Install numpy in Jupyter Notebook

**To install the numpy module on Windows:**

- Type CMD in the search bar and open the Command Prompt application.
- Type
`pip install numpy`

and press Enter.

cmd

`pip install numpy # ๐๏ธ For Python 3 pip3 install numpy # ๐๏ธ If you don't have pip in your PATH environment variable python -m pip install numpy # ๐๏ธ For Python 3 python3 -m pip install numpy # ๐๏ธ Using py alias py -m pip install numpy # ๐๏ธ If you get a permissions error pip install numpy --user # ๐๏ธ For Anaconda conda install -c anaconda numpy`

If the command doesn't succeed, try running CMD as an administrator.

Right-click on the search result, click on "Run as administrator" and run the pip install command.

If you get the error
'pip' is not recognized as an internal or external command,
use the `python -m`

command when installing `numpy`

.

shell

`python -m pip install numpy python3 -m pip install numpy py -m pip install numpy`

Alternatively, you can install the `numpy`

module in a virtual environment:

- Open the root directory of your project.
- Press
`Shift`

and right-click in Explorer.

- Click on "Open PowerShell window here".
- Run the following commands.

PowerShell

`# ๐๏ธ Might also be: "python3 -m venv venv" python -m venv venv # ๐๏ธ Activate on Windows (PowerShell) venv\Scripts\Activate.ps1 # ๐๏ธ Activate on Windows (cmd.exe) venv\Scripts\activate.bat # ๐๏ธ Install `numpy` in your virtual environment pip install numpy`

If the `python -m venv venv`

command doesn't work, try the following 2 commands:

`python3 -m venv venv`

`py -m venv venv`

.

If you see an error message that ps1 cannot be loaded because running scripts is disabled on this system, run the following command, type "yes" when prompted and rerun the activation command.

PowerShell

`Set-ExecutionPolicy RemoteSigned -Scope CurrentUser`

You can verify that the

`numpy`

module is installed by using the `pip show numpy`

command.PowerShell

`pip show numpy pip3 show numpy python -m pip show numpy python3 -m pip show numpy`

The `pip show numpy`

command will either state that the package is not installed
or show a bunch of information about the package, including the location where
the package is installed.

**To install numpy on macOS or Linux:**

- Search for "terminal" and start the application.
- Type
`pip install numpy`

and press Enter.

terminal

`pip install numpy # ๐๏ธ For Python 3 pip3 install numpy # ๐๏ธ If you get a permissions error sudo pip3 install numpy # ๐๏ธ If you don't have pip in your PATH environment variable python -m pip install numpy # ๐๏ธ For Python 3 python3 -m pip install numpy # ๐๏ธ Alternative if you get a permissions error pip install numpy --user # ๐๏ธ For Anaconda conda install -c anaconda numpy`

If you get an error that `pip`

isn't found, use the `python -m`

command.

terminal

`python -m pip install numpy python3 -m pip install numpy`

If you get a permissions error, prefix the command with `sudo`

.

terminal

`sudo pip install numpy sudo pip3 install numpy`

Alternatively, you can install the `numpy`

package in a virtual environment:

- Open your terminal in the root directory of your project.
- Run the following commands.

shell

`# ๐๏ธ Could also be "python -m venv venv" python3 -m venv venv # ๐๏ธ Activate virtual env on macOS or Linux source venv/bin/activate # ๐๏ธ Install numpy in your virtual environment pip install numpy`

Your virtual environment will use the version of Python that was used to create it.

If the

`python3 -m venv venv`

command doesn't work, use `python -m venv venv`

instead.You can use the `pip show`

command to verify
`numpy`

has been installed
successfully.

shell

`pip show numpy pip3 show numpy python -m pip show numpy python3 -m pip show numpy`

The `pip show numpy`

command will either state that the package is not installed
or show a bunch of information about the package.

**To install numpy in Visual Studio Code:**

- Press CTRL + ` (Backtick) on your keyboard to open the terminal.
- Run the
`pip install numpy`

command to install the`numpy`

module.

terminal

`pip install numpy # ๐๏ธ For Python 3 pip3 install numpy # ๐๏ธ If you get a permissions error sudo pip3 install numpy # ๐๏ธ If you don't have pip in your PATH environment variable python -m pip install numpy # ๐๏ธ For Python 3 python3 -m pip install numpy # ๐๏ธ Using py alias py -m pip install numpy # ๐๏ธ Alternative if you get a permissions error pip install numpy --user`

You can also open the terminal in Visual Studio Code by pressing

`CTRL+Shift+P`

and then type "View: Toggle Terminal".When installing Python modules in Visual Studio code, make sure that your IDE is configured to use the correct Python version.

Press `CTRL+Shift+P`

or (`โ`

+ `Shift`

+ `P`

on Mac) to open the command
palette.

Then type "Python select interpreter" in the field.

Then Select the correct Python version from the dropdown menu.

Your IDE should be using the same version of Python (including the virtual environment) that you are using to install packages from your terminal.

You can use the `python --version`

command if you need to get your version of
Python.

terminal

`python --version python3 --version`

You can also try creating a virtual environment if you don't already have one.

terminal

`# ๐๏ธ Could also be "python -m venv venv" or "py -m venv venv" python3 -m venv venv # ๐๏ธ Activate on Unix or MacOS source venv/bin/activate # ๐๏ธ Activate on Windows (cmd.exe) venv\Scripts\activate.bat # ๐๏ธ Activate on Windows (PowerShell) venv\Scripts\Activate.ps1 # ๐๏ธ Install numpy in your virtual environment pip install numpy`

Your virtual environment will use the version of Python that was used to create it.

**To install numpy in PyCharm:**

- Press
`Alt+F12`

on your keyboard to open the terminal. - Run the
`pip install numpy`

command to install the`numpy`

module.

terminal

`pip install numpy # ๐๏ธ For Python 3 pip3 install numpy # ๐๏ธ If you get a permissions error sudo pip3 install numpy # ๐๏ธ If you don't have pip in your PATH environment variable python -m pip install numpy # ๐๏ธ For Python 3 python3 -m pip install numpy # ๐๏ธ Using py alias py -m pip install numpy # ๐๏ธ Alternative if you get a permissions error pip install numpy --user`

Alternatively, you can use the IDE itself to install the module.

- Click on "File" > "Settings" > "Project" > "Python Interpreter".
- Click on the
`+`

icon and type`numpy`

. - Click on "Install Package".

When installing Python modules in PyCharm, make sure that your IDE is configured to use the correct version of Python.

Click on "File" > "Settings" > "Project" > "Python Interpreter".

Then Select the correct Python version from the dropdown menu.

You can use the `python --version`

command if you need to get your version of
Python.

terminal

`python --version python3 --version`

**To install numpy in Anaconda:**

- Open your Anaconda Navigator.
- Click on "Environments" and select your project.
- Type
`numpy`

in the search bar to the right. - Tick the
`numpy`

package and click on "Apply".

Alternatively, you can install the `numpy`

package with a command.

If you are on Windows, search for **"Anaconda Prompt"** and open the
application.

If you are on macOS or Linux, open your terminal.

Run the following command to install the `numpy`

package.

shell

`# ๐๏ธ Using conda conda install -c anaconda numpy # ๐๏ธ Alternatively use `pip` pip install numpy # ๐๏ธ For Python 3 pip3 install numpy # ๐๏ธ If you get a permissions error sudo pip3 install numpy # ๐๏ธ If you don't have pip in your PATH environment variable python -m pip install numpy # ๐๏ธ For Python 3 python3 -m pip install numpy # ๐๏ธ Using py alias py -m pip install numpy # ๐๏ธ Alternative if you get a permissions error pip install numpy --user`

Click on the following article if you need to install a specific version of the package using Anaconda.

**To install numpy in Jupyter Notebook:**

- Open your terminal and type "jupyter notebook".

- Click on "New" and then "Terminal" in the browser tab.

- Type
`pip install numpy`

and press Enter.

shell

`# ๐๏ธ Using pip pip install numpy # ๐๏ธ For Python 3 pip3 install numpy # ๐๏ธ If you get a permissions error sudo pip3 install numpy # ๐๏ธ If you don't have pip in your PATH environment variable python -m pip install numpy # ๐๏ธ For Python 3 python3 -m pip install numpy # ๐๏ธ Using py alias py -m pip install numpy # ๐๏ธ Using conda conda install -c anaconda numpy # ๐๏ธ Alternative if you get a permissions error pip install numpy --user`

Alternatively, you can use the Python ipykernel.

- Open your terminal and type "jupyter notebook".

Click on "New" and then click on "Python 3 (ipykernel)".

Type

`!pip install numpy`

and click on "Run".

Note that the `pip install`

command must be prefixed with an exclamation mark if
you use this approach.

shell

`!pip install numpy`

Once you type the command, click "Run" to install the `numpy`

module.

If you get a permissions error, e.g. "[WinError: 5] Access is denied", add the
`--user`

option to the installation command.

shell

`!pip install numpy --user`

If the error persists, try to restart the Jupyter Kernel and rerun the command.