← Back to package-management tools

pip

package-managerPythonPyPICLIvirtual-environmentdependency-management

Package Manager

pip

Overview

pip (Pip Installs Packages) is Python's standard package manager. It enables efficient searching, installation, and management of Python libraries from the Python Package Index (PyPI), which hosts over 500,000 packages. Included by default with Python 3.4 and later, pip serves billions of downloads monthly and forms the core tool of the Python ecosystem. As of 2024, pip 24.3 series is available as the latest version.

Details

Key Features

  • Standard Installation: Included by default with Python 3.4 and later
  • Rich Ecosystem: Over 500,000 packages registered on PyPI
  • Virtual Environment Support: Complete integration with venv and virtualenv
  • Enhanced Security: pip audit functionality and system certificate store support (pip 24.2+)
  • Dependency Resolution: Automatic dependent package management
  • requirements.txt: File-based project dependency management

Architecture

pip consists of three main components:

  1. PyPI (Python Package Index): Central repository where packages are stored
  2. pip Client: Command-line interface (CLI)
  3. requirements.txt: Project dependency definition file

Major Updates in 2024

  • System Certificate Store Integration (pip 24.2): Resolves connection issues in corporate environments
  • Performance Improvements: Significant speed improvements for large-scale projects
  • Enhanced PEP 517 Support: Integration with modern build systems
  • Strict Version Validation: Rejection of packages with invalid metadata
  • Legacy Editable Install Deprecation: Migration to safer installation methods

Package Management Mechanism

  • Dependency Resolution: Automatically downloads and installs required packages
  • Version Management: Flexible specification using semantic versioning
  • Caching: Local caching of downloaded packages
  • Virtual Environment Support: Isolated management of project-specific dependencies

Advantages and Disadvantages

Advantages

  • Low Learning Curve: Simple and intuitive command structure
  • Standard Installation: Installed with Python, no separate installation required
  • Rich Ecosystem: World's largest Python package library
  • Virtual Environment Integration: Complete integration with venv and virtualenv
  • Corporate Environment Support: System certificate store integration for corporate firewalls
  • Community Support: Continuous development by the official Python team

Disadvantages

  • Dependency Conflicts: Difficulty resolving conflicts in complex dependency scenarios
  • Performance: Can be slower than other tools (poetry, conda) in large projects
  • No Lock File Support: Additional tools like pip-tools are required
  • Development Environment Management: Manual management of production environment differences
  • Uninstall Issues: Residual files from dependency removal

Reference Pages

Usage Examples

Package Installation

# Basic package installation
pip install requests

# Install specific version
pip install django==4.2.0

# Install with version range
pip install "flask>=2.0,<3.0"

# Install multiple packages simultaneously
pip install requests beautifulsoup4 pandas

# Upgrade to latest version
pip install --upgrade numpy

# Install to user directory (no admin rights required)
pip install --user matplotlib

Requirements.txt Management

# Generate requirements.txt from current environment
pip freeze > requirements.txt

# Install packages from requirements.txt
pip install -r requirements.txt

# Separate development and production requirements
pip install -r requirements-dev.txt
pip install -r requirements-prod.txt

# Example requirements.txt

# requirements.txt example
django==4.2.7
requests>=2.31.0
numpy>=1.24.0
pandas>=2.0.0
pytest>=7.4.0  # for development
black>=23.0.0   # for development (code formatter)

Virtual Environment Integration

# Create virtual environment
python -m venv myproject_env

# Activate virtual environment (Windows)
myproject_env\Scripts\activate

# Activate virtual environment (Linux/macOS)
source myproject_env/bin/activate

# Install packages within virtual environment
pip install flask sqlalchemy

# Save virtual environment dependencies
pip freeze > requirements.txt

# Deactivate virtual environment
deactivate

Package Search and Information

# Search packages (note: currently disabled on PyPI)
pip search django

# Show detailed package information
pip show requests

# List installed packages
pip list

# Check outdated packages
pip list --outdated

# Show package dependencies
pip show --verbose tensorflow

# Show package file information
pip show --files requests

Dependency Management

# Display dependency tree (requires pipdeptree)
pip install pipdeptree
pipdeptree

# Check for broken dependencies
pip check

# Uninstall package
pip uninstall requests

# Uninstall without confirmation
pip uninstall --yes requests

# Uninstall with dependencies (requires pip-autoremove)
pip install pip-autoremove
pip-autoremove django -y

Updates and Uninstallation

# Update pip itself
python -m pip install --upgrade pip

# Bulk update all packages (requires pip-review)
pip install pip-review
pip-review --local --interactive

# Security vulnerability check (using safety)
pip install safety
safety check

# Clear cache
pip cache purge

# Download package (without installing)
pip download requests --dest ./downloads

# Install local package
pip install ./my-package/
pip install -e ./my-package/  # development mode (editable install)