How to Uninstall a Python Package With Pip: Step-by-Step Guide

PDF download Download Article
Easily uninstall Python packages using Pip on any operating system
PDF download Download Article

Are you trying to use Pip to uninstall a Python package? Thankfully, whether you're on Windows, macOS, or Unix (Linux) this is a simple task. In this article we'll go over all the steps to uninstall a package with Pip, including some optional steps to remove dependencies or globally-installed packages.

Quick Pip Uninstallation Steps

  1. Open your terminal or command prompt.
  2. Start the command with python (Unix/macOS) or py (Windows).
  3. Write pip -m uninstall [packagename] .
  4. Press Enter / Return to execute the command.
  5. Type y to confirm the uninstallation.

Steps

PDF download Download Article
  1. {"smallUrl":"https:\/\/www.wikihow.com\/images\/thumb\/9\/99\/Pip-Uninstall-Package-Step-1.jpg\/v4-460px-Pip-Uninstall-Package-Step-1.jpg","bigUrl":"\/images\/thumb\/9\/99\/Pip-Uninstall-Package-Step-1.jpg\/v4-728px-Pip-Uninstall-Package-Step-1.jpg","smallWidth":460,"smallHeight":345,"bigWidth":728,"bigHeight":546,"licensing":"<div class=\"mw-parser-output\"><p>License: <a target=\"_blank\" rel=\"nofollow noreferrer noopener\" class=\"external text\" href=\"https:\/\/en.wikipedia.org\/wiki\/Fair_use\">Fair Use<\/a> (screenshot)<br>\n<\/p><\/div>"}
    While you most commonly may use pip , there are different pip commands you can use depending on your circumstances:
    • pip : Python 2.7
    • pip3.4 : Python 3.4
    • pip3.6 : Python 3.6
  2. {"smallUrl":"https:\/\/www.wikihow.com\/images\/thumb\/b\/bc\/Pip-Uninstall-Package-Step-2.jpg\/v4-460px-Pip-Uninstall-Package-Step-2.jpg","bigUrl":"\/images\/thumb\/b\/bc\/Pip-Uninstall-Package-Step-2.jpg\/v4-728px-Pip-Uninstall-Package-Step-2.jpg","smallWidth":460,"smallHeight":345,"bigWidth":728,"bigHeight":546,"licensing":"<div class=\"mw-parser-output\"><p>License: <a target=\"_blank\" rel=\"nofollow noreferrer noopener\" class=\"external text\" href=\"https:\/\/en.wikipedia.org\/wiki\/Fair_use\">Fair Use<\/a> (screenshot)<br>\n<\/p><\/div>"}
    The program you open to use Pip depends on your operating system.
    Advertisement
  3. {"smallUrl":"https:\/\/www.wikihow.com\/images\/thumb\/8\/80\/Pip-Uninstall-Package-Step-3.jpg\/v4-460px-Pip-Uninstall-Package-Step-3.jpg","bigUrl":"\/images\/thumb\/8\/80\/Pip-Uninstall-Package-Step-3.jpg\/v4-728px-Pip-Uninstall-Package-Step-3.jpg","smallWidth":460,"smallHeight":345,"bigWidth":728,"bigHeight":546,"licensing":"<div class=\"mw-parser-output\"><p>License: <a target=\"_blank\" rel=\"nofollow noreferrer noopener\" class=\"external text\" href=\"https:\/\/en.wikipedia.org\/wiki\/Fair_use\">Fair Use<\/a> (screenshot)<br>\n<\/p><\/div>"}
    If you're on Unix or macOS , start your command with python . If you're on Windows, start it with py . Then, write the following command:
    • -m pip uninstall [packagename] [1]
      • Replace pip with one of the alternatives in step 1, if necessary.
      • Replace [packagename] with the name of the package you want to uninstall.
  4. {"smallUrl":"https:\/\/www.wikihow.com\/images\/thumb\/5\/56\/Pip-Uninstall-Package-Step-4.jpg\/v4-460px-Pip-Uninstall-Package-Step-4.jpg","bigUrl":"\/images\/thumb\/5\/56\/Pip-Uninstall-Package-Step-4.jpg\/v4-728px-Pip-Uninstall-Package-Step-4.jpg","smallWidth":460,"smallHeight":345,"bigWidth":728,"bigHeight":546,"licensing":"<div class=\"mw-parser-output\"><p>License: <a target=\"_blank\" rel=\"nofollow noreferrer noopener\" class=\"external text\" href=\"https:\/\/en.wikipedia.org\/wiki\/Fair_use\">Fair Use<\/a> (screenshot)<br>\n<\/p><\/div>"}
    The terminal will ask if you want to proceed when you attempt to uninstall a file. Type y to proceed (or no to cancel the uninstall).
  5. {"smallUrl":"https:\/\/www.wikihow.com\/images\/thumb\/4\/4e\/Pip-Uninstall-Package-Step-5.jpg\/v4-460px-Pip-Uninstall-Package-Step-5.jpg","bigUrl":"\/images\/thumb\/4\/4e\/Pip-Uninstall-Package-Step-5.jpg\/v4-728px-Pip-Uninstall-Package-Step-5.jpg","smallWidth":460,"smallHeight":345,"bigWidth":728,"bigHeight":546,"licensing":"<div class=\"mw-parser-output\"><p>License: <a target=\"_blank\" rel=\"nofollow noreferrer noopener\" class=\"external text\" href=\"https:\/\/en.wikipedia.org\/wiki\/Fair_use\">Fair Use<\/a> (screenshot)<br>\n<\/p><\/div>"}
    If you installed a package globally as well as locally, uninstalling it globally is necessary to cleanly remove the package from your computer.
    • Windows: After entering the command window, press Ctrl + ⇧ Shift + ↵ Enter to get admin privileges, then execute the pip uninstall [packagename] command again.
    • Unix/macOS: After opening a terminal window, execute the command sudo su pip uninstall [packagename] .
  6. {"smallUrl":"https:\/\/www.wikihow.com\/images\/thumb\/5\/5b\/Pip-Uninstall-Package-Step-6.jpg\/v4-460px-Pip-Uninstall-Package-Step-6.jpg","bigUrl":"\/images\/thumb\/5\/5b\/Pip-Uninstall-Package-Step-6.jpg\/v4-728px-Pip-Uninstall-Package-Step-6.jpg","smallWidth":460,"smallHeight":345,"bigWidth":728,"bigHeight":546,"licensing":"<div class=\"mw-parser-output\"><p>License: <a target=\"_blank\" rel=\"nofollow noreferrer noopener\" class=\"external text\" href=\"https:\/\/en.wikipedia.org\/wiki\/Fair_use\">Fair Use<\/a> (screenshot)<br>\n<\/p><\/div>"}
    Some packages also install dependencies, and these are not removed when you uninstall a package. There are two ways you can remove dependent packages:
    • Run a pip uninstall requirements.txt command. If the requirements file is not named requirements.txt , change the command to the proper requirements file name.
    • Run pip show [packagename] to see the dependencies for the given package. You can then use pip uninstall to uninstall these packages.
      • Always make sure the dependent packages are not dependencies for other packages you still have installed.
    7. Advertisement

Expert Q&A

Ask a Question
200 characters left
Include your email address to get a message when this question is answered.
Submit
      Advertisement

      Video

      Tips

      • Pure distutils packages installed with setup.py install and script wrappers installed with setup.py develop cannot be removed with pip .
        Thanks
        Helpful 0 Not Helpful 0
      Submit a Tip
      All tip submissions are carefully reviewed before being published
      Name
      Please provide your name and last initial
      Submit
      Thanks for submitting a tip for review!
      Advertisement

      You Might Also Like

      How to
      Use Windows Command Prompt to Run a Python File
      How to
      Upgrade Pip: Quick Guide for Beginners & Experts
      How to
      Open a Python File
      How to
      Comment Out Multiple Lines in Python: Formatting & Shortcuts
      3 Easy Ways to Download & Install Pip on Your Mac
      How to
      See the Python Version on Mac, Windows, and Linux
      How to
      Start Programming in Python
      How to
      Change the Font Size in Python Shell
      How to
      Uninstall Python
      How to
      Code a Python Countdown Timer: Step-by-Step Guide
      How to
      Program a Game in Python with Pygame
      How to
      Create Loops in Python
      How to
      Write a Coin Flipping Program on Python
      How to
      Write a Python Program to Calculate Pi
      Advertisement

      References

      1. ↑ https://pip.pypa.io/en/stable/cli/pip_uninstall/

      About This Article

      Thanks to all authors for creating a page that has been read 26,251 times.

      Is this article up to date?

      Advertisement