In this lesson, you will learn why installing Python packages globally creates "dependency hell" and how it risks breaking your existing projects.
The Problem with Global Installs
When you run a command like pip install requests in your terminal without an active virtual environment, Python installs that library into your system’s global site-packages directory. This directory is shared by every Python script and application on your operating system.
Imagine you have two projects:
- Project A requires
requests==2.25.0to function. - Project B requires
requests==2.31.0to utilize a new feature.
If you install these globally, the second installation will overwrite the first. Now, Project A is broken because it expects a version of the library that no longer exists on your machine. This is what we call Global Environment Pollution. Your OS-level Python installation becomes a fragile, monolithic mess where upgrading one library accidentally triggers a cascade of failures across all your unrelated projects.
Illustrating the Conflict
Think of your global environment as a single shared refrigerator for an entire apartment complex. If Project A puts a gallon of milk in there, and Project B decides to replace it with a different brand, Project A’s recipe is ruined.
You can observe this by running pip list in your terminal. You will likely see dozens of packages installed for different purposes. If you try to update one to satisfy a new requirement, you might inadvertently break a system tool or an older script that relied on an obscure, older version of that package.
# Don't do this!
pip install requests # Pollutes the global environment
# Do this instead (Concept: Virtual Environments)
python -m venv venv # Create a local isolation layer
source venv/bin/activate # Activate, so only this project sees the installed packages
pip install requests # Safely contained within this project
By keeping dependencies local to the project, you ensure that each application remains self-contained, reproducible, and immune to the "pollution" caused by other software running on your machine.
Key Takeaway: Never install packages globally; always use isolated environments to prevent dependency conflicts and ensure your project’s stability across different version requirements.