DEV Community

Russell Jones
Russell Jones

Posted on • Originally published at jonesrussell.github.io on

Python Virtual Environments for Beginners

If you’re new to Python, you might have heard about virtual environments but aren’t sure what they are or why you need them. Let’s break it down in simple terms!

What’s a Virtual Environment?

Think of a virtual environment like a clean room for your Python project. It’s an isolated space where you can install packages and dependencies without affecting your computer’s main Python installation or other projects.

Why Do You Need One?

Imagine you’re working on two Python projects:

  • Project A needs version 1.0 of a package
  • Project B needs version 2.0 of the same package

Without virtual environments, you’d have a conflict! Virtual environments solve this by giving each project its own separate space with its own packages.

How to Create a Virtual Environment

It’s surprisingly simple! You only need two commands:

# Create the virtual environment
python3 -m venv venv

# Activate it
source venv/bin/activate

Enter fullscreen mode Exit fullscreen mode

Let’s break down that first command:

  • python3 - runs Python 3
  • -m venv - tells Python to run the venv module
  • The last venv - is just the name of the directory (you can name it anything)

How to Know It’s Working

When your virtual environment is active, you’ll see (venv) at the start of your terminal prompt:

(venv) username@computer:~/project$

Enter fullscreen mode Exit fullscreen mode

Installing Packages

Once your virtual environment is active, you can install packages using pip:

pip install requests

Enter fullscreen mode Exit fullscreen mode

These packages will only be installed in your virtual environment, keeping your system Python clean.

Common Commands

# Create virtual environment
python3 -m venv venv

# Activate it
source venv/bin/activate

# Install packages
pip install requests
pip install -r requirements.txt # install from a requirements file

# See what's installed
pip list

# Deactivate when you're done
deactivate

Enter fullscreen mode Exit fullscreen mode

Best Practices

  1. Create a virtual environment for each Python project
  2. Add venv/ to your .gitignore file
  3. Keep a requirements.txt file listing your project dependencies
  4. Activate the virtual environment before working on your project

Wrapping Up

Virtual environments might seem like extra work at first, but they’re a crucial tool for Python development. They keep your projects isolated, make them more portable, and help avoid dependency conflicts.

Remember: if you’re starting a new Python project, creating a virtual environment should be your first step!

Top comments (0)