Essential pip Tips and Tricks for Python Package Management

pip is the default Python package manager that can install, update, and uninstall third‑party libraries from the PyPI repository.

1. Install pip

pip is bundled with Python 3.4 and later; if missing, you can install it via easy_install pip or by downloading the installer and running python setup.py install .

2. Upgrade pip

Upgrade the current pip version with pip install --upgrade pip or the short form pip install -U pip .

$ pip install -U pip
Looking in indexes: https://pypi.python.org/simple
Requirement already satisfied: pip in ./test/lib/python3.8/site-packages (21.1.1)
Collecting pip
  Using cached pip-22.0.4-py3-none-any.whl (2.1 MB)
Installing collected packages: pip
  Attempting uninstall: pip
    Found existing installation: pip 21.1.1
    Uninstalling pip-21.1.1:
      Successfully uninstalled pip-21.1.1
Successfully installed pip-22.0.4

3. Install packages

Use pip install package_name to add a library, optionally specifying a version with == , e.g., pip install matplotlib==3.4.1 .

4. Batch install libraries

Install many packages at once from a requirements.txt file using pip install -r requirements.txt . Example requirements.txt content includes comments, index specifications, version constraints, and direct file paths.

# This is a comment
# Specify a different index
-i http://dist.repoze.org/zope2/2.10/simple
# Package with versions
tensorflow==2.3.1
uvicorn==0.12.2
fastapi==0.63.0
pkg1
pkg2
pkg3>=1.0,<2.0
# Local wheel
./downloads/numpy-1.9.2-cp34-none-win32.whl
# Other requirement files
-r other-requirements.txt
-c constraints.txt
# Plain names
pytest
beautifulsoup4

5. Uninstall and upgrade packages

Remove a package with pip uninstall package_name . Upgrade an installed package using pip install --upgrade package_name or the short form pip install -U package_name .

$ pip uninstall requests
$ pip install --upgrade requests

6. Freeze dependencies

List all installed packages with pip freeze or generate a requirements.txt file via pip freeze > requirements.txt . Use -l/--local to show only non‑global packages.

# List packages
$ pip freeze
docutils==0.11
Jinja2==2.7.2
MarkupSafe==0.19
Pygments==1.6
Sphinx==1.2.2
# Generate requirements.txt file
$ pip freeze > requirements.txt

7. View package information

Retrieve detailed info about a package with pip show -f package_name .

$ pip show -f pyyaml
Name: PyYAML
Version: 5.4.1
Summary: YAML parser and emitter for Python
Home-page: https://pyyaml.org/
Author: Kirill Simonov
License: MIT
Location: /private/tmp/test/lib/python3.8/site-packages
Requires:
Required-by: awscli
Files:
  PyYAML-5.4.1.dist-info/INSTALLER
  ...

8. List outdated packages

Identify packages with newer versions using pip list -o .

$ pip list -o
Package    Version Latest Type
---------- ------- ------ -----
docutils   0.15.2  0.18.1 wheel
PyYAML     5.4.1   6.0    wheel
rsa        4.7.2   4.8    wheel
setuptools 56.0.0  62.1.0 wheel

9. Check compatibility issues

Verify that installed packages have compatible dependencies with pip check [package-name] . Omitting a name checks all packages.

$ pip check awscli
No broken requirements found.
$ pip check
pyramid 1.5.2 requires WebOb, which is not installed.

10. Download packages locally

Save a package to a local directory in wheel format using pip download package_name -d "path" .

$ pip download PyYAML -d "/tmp/"
Looking in indexes: https://pypi.python.org/simple
Collecting PyYAML
  Downloading PyYAML-6.0-cp38-cp38-macosx_10_9_x86_64.whl (192 kB)
Saved ./PyYAML-6.0-cp38-cp38-macosx_10_9_x86_64.whl
Successfully downloaded PyYAML
$ ls /tmp/PyYAML-6.0-cp38-cp38-macosx_10_9_x86_64.whl