Master Python Environment Isolation: Virtualenv, Pyenv, and Tox Explained

Python projects often suffer from package conflicts and version incompatibilities, especially when different projects require different dependencies or Python versions. This article introduces several tools for isolating Python environments and managing versions.

Virtualenv

Virtualenv creates an isolated Python environment for each project, preventing global package conflicts.

pip install virtualenv

Creating and using a virtual environment:

sitin@test:/data/opt/test$ virtualenv venv
sitin@test:/data/opt/test$ source venv/bin/activate
(venv) sitin@test:/data/opt/test$ deactivate
sitin@test:/data/opt/test$

Virtualenvwrapper

Virtualenvwrapper adds convenient commands for managing virtual environments, allowing one‑click activation.

pip install virtualenvwrapper mkdir ~/.virtualenvs

Typical configuration (add to .bashrc or .zshrc):

export WORKON_HOME=$HOME/.virtualenvs  # directory for environments
export VIRTUALENVWRAPPER_PYTHON=/usr/bin/python
export VIRTUALENVWRAPPER_VIRTUALENV_ARGS='--no-site-packages'
export PIP_VIRTUALENV_BASE=$WORKON_HOME
export PIP_RESPECT_VIRTUALENV=true
if [[ -r /usr/local/bin/virtualenvwrapper.sh ]]; then
    source /usr/local/bin/virtualenvwrapper.sh
else
    echo "WARNING: Can't find virtualenvwrapper.sh"
fi

Common commands:

mkvirtualenv your_project # create rmvirtualenv your_project # delete workon # list projects workon your_project # activate

Pyenv

Pyenv manages multiple Python versions and can be combined with virtualenv or virtualenvwrapper.

brew install pyenv brew install pyenv-virtualenv brew install pyenv-virtualenvwrapper

Add the following to your shell configuration (e.g., .zshrc):

# ---pyenv---
export PATH="$HOME/.pyenv/bin:$PATH"
eval "$(pyenv init -)"
eval "$(pyenv virtualenv-init -)"

Example usage:

pyenv install -l  # list installable versions
pyenv install 3.7.1  # install Python 3.7.1
pyenv global 3.7.1   # set global version
pyenv virtualenv test-pyenv-venv  # create virtualenv
pyenv activate test-pyenv-venv   # activate
pyenv deactivate                # deactivate

Tox

Tox enables testing across multiple Python versions, making it easy to ensure code works on both Python 2 and Python 3.

It is recommended for projects that need to maintain compatibility across versions.

Python also provides a built‑in venv module for creating virtual environments, though its adoption is still limited compared to the tools above.