pip cli

list

• The packages shown are coupled to the pip binary ran
• If you ran the pip binary from your venv you will probably have several project dependencies
• If you the the pip binary from the system-wide installed you will have few dependencies, usually the packages pip, wheel
• Other system packages may have installed packages on behalf of pip. You should not uninstall them directly (e.g., nmap via brew install ndiff via pip)
• Do not install global packages via pip!

pip list

show

• Show information about a package, including where it is installed and its dependencies

pip show "pip"

install

# install system-wide (/usr/lib/python3.13/site-packages/ and /usr/bin/) - NOT recommended
pip install <package>

# install per user (~/.local/lib/python3.13/site-packages/ and ~/.local/bin/) - OKAY
pip install --user <package>

# install in venv (<venv>/lib/python3.13/site-packages/ and <venv>/bin)
(myenv) pip install <package>

# install system-wide (global), but isolated (OKAY)
pipx install black

# install a package globally
pip install numpy
pip install "numpy[standard]" # specify version

# upgrade package to the newest version (install or upgrade it)
pip install --upgrade pip # -U upgrade pip itself

# install from a directory
git clone https://github.com/squidfunk/mkdocs-material.git
pip install -e mkdocs-material
pip install -e '.[dev]'   # installs the package + pytest

# install from requirements file
pip install -r requirements.txt
pip install --no-cache-dir --upgrade -r /code/requirements.txt # Do not save downloaded packages into pip's local cache directory (usually ~/.cache/pip). Doesn't make sense in production environment, in which you won't reuse the cache. Also also saves disk space

# install from pyproject file
pip install .

freeze

• Lists all the dependencies and creates a requirements.txt file
• This file contains the direct dependencies required
• To install them all run pip install -r requirements.txt
• Requirements file does not store the hash of the dependencies, so it might potentially be unsafe

pip freeze

mkdocs==1.5.2
mkdocs-material==9.1.21
mkdocs-redirects==1.2.1