How to Install a Python Virtual Environment

Managing dependencies and ensuring a consistent development environment are crucial aspects of any Python project. Virtual environments provide an efficient way to achieve this by isolating project-specific modules and libraries.

In this blog post, we'll guide you through the steps to create and manage a Python virtual environment using the built-in venv library. For simplicity, we'll assume the commands are run on Linux or macOS.

 

Step 1: Navigate to Your Project's Directory

First, navigate to the directory where you want to create your virtual environment. You can do this using the cd command in your terminal.

cd path/to/your/project

 

Step 2: Create the Virtual Environment

To create a virtual environment, run the following command:

python3 -m venv <virtual_environment_name>

Replace <virtual_environment_name> with your preferred name. Common choices are venv or .venv.

 

Step 3: Activate the Virtual Environment

After creating the virtual environment, activate it with the following command:

source <virtual_environment_name>/bin/activate

Or you can use the shorter form:

. <virtual_environment_name>/bin/activate

Once activated, you’ll see a change in your terminal's command line, indicating that the virtual environment is active:

(.venv) username@host project_folder %

 

Step 4: Deactivate the Virtual Environment

To deactivate the virtual environment, simply run:

deactivate

 


Using the venv library is simple and straightforward, making it sufficient for many projects. However, it has some limitations. For more advanced needs, consider using virtualenv, which offers additional features and flexibility. Learn more about virtualenv here.

Category: DIY Tips