LinuxCommandLibrary

pip-uninstall

Uninstall Python packages

TLDR

Uninstall a package

$ pip uninstall [package]
copy

Uninstall packages listed in a specific file
$ pip uninstall [[-r|--requirement]] [path/to/requirements.txt]
copy

Uninstall package without asking for confirmation
$ pip uninstall [[-y|--yes]] [package]
copy

SYNOPSIS

pip uninstall [options] ...

PARAMETERS

-y, --yes
    Don't ask for confirmation of uninstall deletions.

--no-input
    Disable prompting for input during uninstall.

--verbose
    Give more output. Option is additive, and can be used up to 3 times.

--quiet
    Give less output. Option is additive, and can be used up to 3 times (corresponding to WARNING, ERROR, and CRITICAL logging levels).

--log
    Path to a file where a complete (maximum verbosity) record will be kept.

--no-color
    Suppress colored output.

--disable-pip-version-check
    Don't warn when a new pip version is available.

--help
    Show help message and exit.

DESCRIPTION

The pip uninstall command removes one or more Python packages from your system. It uses the package name to identify which packages to remove. pip handles dependency resolution to remove any packages that depend on the target packages. If a package is installed multiple times, pip may only uninstall the latest version. It's crucial to ensure you're uninstalling the correct package and version. You can verify installed packages using 'pip list' or 'pip show'. pip uninstall is typically used within a virtual environment to manage dependencies for specific projects, preventing conflicts between different projects' requirements. The command aims to remove all traces of the package, including installed files, scripts, and metadata. Consider checking your system's package manager if the package was initially installed through that method.

CAVEATS

pip uninstall might not completely remove all traces of a package, especially if files were manually created or modified after installation. Some packages might have uninstallation scripts that don't work as expected. Use carefully when uninstalling system critical libraries!

EXAMPLES

To uninstall a package named 'requests': pip uninstall requests
To uninstall multiple packages: pip uninstall requests beautifulsoup4
To uninstall without asking confirmation: pip uninstall -y requests

HISTORY

pip evolved as a replacement for easy_install, aiming to provide a more robust and user-friendly package management experience for Python. The pip uninstall command was a core component from its early development, enabling users to easily remove installed packages and manage their dependencies. It became an essential tool for Python developers, promoting consistent and reproducible environments.

SEE ALSO

pip install(1), pip list(1), pip show(1)

Copied to clipboard