How to install modules with PIP (and troubleshoot common issues)

GeoSense ✅
2 min readJun 1

PIP is a powerful tool for installing Python modules, but sometimes it can cause problems. In this guide, we’ll cover how to use PIP and troubleshoot common issues that may arise.

Source: unsplash

Using PIP to install modules

Installing modules with PIP is straightforward. Open your terminal or command prompt:

  • Windows: Command Prompt (CMD)
  • MacOS / Linux: Terminal

In the command line, type:

pip install <module_name>

For MacOS and Linux, you may need to use sudo before the pip command:

sudo pip install <module_name>

Troubleshooting PIP

Basic checks

Before diving into troubleshooting, double-check a few things:

  1. Ensure Python is installed on your system.
  2. Confirm that the module you’re trying to install exists. Visit PyPI (Python Package Index) and search for the package. If it doesn’t appear, verify the correct package name through a search engine or Stack Overflow.

Alternate installation commands

If the basic installation command doesn’t work, try these alternatives:

  • Python 3: If you have multiple Python versions installed, including Python 3, use pip3 instead of pip: pip3 install <module_name>

Installing from a wheel package

If the module is no longer available on PyPI, you may find a wheel package (.whl) for it. To install from a wheel package, use one of the following commands:

pip install <path_to_whl_file>
pip3 install <path_to_whl_file>
python -m pip install <path_to_whl_file>
python3 -m pip install <path_to_whl_file>

Upgrading PIP

If PIP itself is causing issues, try upgrading it:

python -m pip install --upgrade pip

If the above command fails, you can try installing PIP from scratch:

  1. Obtain the file from the official Python website or save it from…
GeoSense ✅

🌏 Remote sensing | 🛰️ Geographic Information Systems (GIS) | ℹ️

Recommended from Medium


See more recommendations