Skip to main content

Introduction to Pip: The Python Package Manager

So far, we've worked with our own modules and those from Python's extensive Standard Library. But the true power of the Python ecosystem comes from the millions of third-party packages created by the community. To access this vast universe of code, you need a package manager. For Python, that tool is pip.

This article introduces pip, the standard package manager for Python, which allows you to find, install, and manage these third-party libraries.

📚 Prerequisites​

You should have Python installed on your system. Modern versions of Python (3.4+) come with pip automatically. You can verify this by opening your terminal or command prompt and running:

pip --version
# or for some systems
pip3 --version

If you see a version number, you're ready to go!

🎯 Article Outline: What You'll Master​

In this article, you will learn:

  • ✅ What Pip and PyPI Are: Understand the relationship between the package manager (pip) and the package repository (PyPI).
  • ✅ Installing a Package: How to use pip install to add new functionality to your Python environment.
  • ✅ Viewing Installed Packages: How to use pip list to see what's currently installed.
  • ✅ Removing a Package: How to use pip uninstall to clean up your environment.

🧠 Section 1: What are Pip and PyPI?​

  • Pip: The name pip is a recursive acronym for "Pip Installs Packages". It's a command-line tool that lets you install and manage libraries for your Python projects.
  • PyPI (The Python Package Index): This is a massive, community-hosted online repository of open-source Python packages. When you run pip install some-package, pip connects to PyPI, finds the package, downloads it, and installs it on your system. Think of it as an app store for Python code.

Every time you need to accomplish a new task, from web scraping to data analysis, there's a good chance a helpful package already exists on PyPI.

💻 Section 2: Your First Installation with pip install​

This is the most fundamental pip command. Let's say you want to write a script that makes requests to a web API. Instead of writing all the complex networking code yourself, you can use the incredibly popular requests library.

To install it, you simply run this command in your terminal:

pip install requests

Pip will connect to PyPI, find the requests package, and install it. It will also automatically install any other packages that requests itself depends on to function correctly.

Once the installation is complete, you can immediately use the library in any Python script:

# simple_api_call.py
import requests

# Use the requests library to get data from the public GitHub API
response = requests.get("https://api.github.com")

# The response object contains the status code, headers, and data
print(f"Status Code: {response.status_code}")
if response.status_code == 200:
    print("Successfully connected to the GitHub API!")

🛠️ Section 3: Managing Your Packages​

Once you start installing packages, you'll need a way to see what you have and remove what you no longer need.

3.1 - pip list: Seeing What's Installed​

How do you know what packages are in your environment? The list command shows you everything.

pip list

Example Output:

Package           Version
----------------- -------
certifi           2023.7.22
charset-normalizer 3.3.2
idna              3.4
pip               23.3.1
requests          2.31.0  <-- There's the package we installed!
urllib3           2.0.7

You can see requests in the list, along with its dependencies that pip handled for you.

3.2 - pip uninstall: Removing a Package​

If you're finished with a project or installed a package by mistake, you can easily remove it with the uninstall command.

pip uninstall requests

Pip will show you the files it's going to remove and ask for confirmation (y/n). This helps prevent accidental deletions.

✨ Conclusion & Key Takeaways​

You've just taken your first step into a much larger world of Python development. pip is the essential tool that connects you to the work of millions of developers, allowing you to build powerful applications without starting from scratch every time.

Let's summarize the key takeaways:

  • pip is the Tool, PyPI is the Store: pip installs packages from the Python Package Index.
  • pip install <package-name>: The command to install any package from PyPI.
  • pip list: Shows all packages currently in your environment.
  • pip uninstall <package-name>: Removes a package from your environment.

Challenge Yourself:

  1. Find a package on PyPI that looks interesting to you. A fun and simple one is colorama, which lets you add color to your terminal text.
  2. Install it using pip install colorama.
  3. Run pip list to confirm it was installed.
  4. Write a small Python script to test out its functionality (check the colorama PyPI page for usage examples!).
  5. When you're done, clean up by running pip uninstall colorama.

➡️ Next Steps​

Now that you know how to install individual packages, the next logical step is to learn how to manage all the dependencies for a single project. In our next article, we'll cover "Installing and Managing Packages with Pip: Using requirements.txt," where you'll learn the standard professional workflow for keeping track of project dependencies.

Happy installing!