View this page
  


  
  
  
    
    Edit this page
  

          
            Toggle table of contents sidebar
            
          
        
          
pip uninstall¶

Usage¶

Unix/macOSpython -m pip uninstall [options] <package> ...
python -m pip uninstall [options] -r <requirements file> ...

Windowspy -m pip uninstall [options] <package> ...
py -m pip uninstall [options] -r <requirements file> ...




Description¶
Uninstall packages.
pip is able to uninstall most installed packages. Known exceptions are:

Pure distutils packages installed with python setup.py install, which
leave behind no metadata to determine what files were installed.
Script wrappers installed by python setup.py develop.




Options¶


-r, --requirement <file>¶
Uninstall all the packages listed in the given requirements file.  This option can be used multiple times.
(environment variable: PIP_REQUIREMENT)




-y, --yes¶
Don’t ask for confirmation of uninstall deletions.
(environment variable: PIP_YES)




--root-user-action <root_user_action>¶
Action if pip is run as a root user [warn, ignore] (default: warn)
(environment variable: PIP_ROOT_USER_ACTION)




--break-system-packages¶
Allow pip to modify an EXTERNALLY-MANAGED Python installation
(environment variable: PIP_BREAK_SYSTEM_PACKAGES)





Examples¶

Uninstall a package.

Unix/macOS$ python -m pip uninstall simplejson
Uninstalling simplejson:
   /home/me/env/lib/python3.9/site-packages/simplejson
   /home/me/env/lib/python3.9/site-packages/simplejson-2.2.1-py3.9.egg-info
Proceed (Y/n)? y
   Successfully uninstalled simplejson

WindowsC:\> py -m pip uninstall simplejson
Uninstalling simplejson:
   /home/me/env/lib/python3.9/site-packages/simplejson
   /home/me/env/lib/python3.9/site-packages/simplejson-2.2.1-py3.9.egg-info
Proceed (Y/n)? y
   Successfully uninstalled simplejson