We use virtualenv to manage Python environments for you. We currently support Python 2.7.6. Version 3.4.3 of Python is installed as well and available via the python3 binary.


You can use pip to install any dependencies, for example:

pip install -r requirements.txt

Python 3

The virtual environment from ${HOME}/.virtualenv is activated and configured for use with Python 2 by default. If you want to switch to version 3, simply add the following commands to your Setup Commands.

virtualenv -p $(which python3) "${HOME}/cache/python3_env"
source "${HOME}/cache/python3_env/bin/activate"

Additional Versions

If you need a specific Python version installed, use this script in your Setup Commands.

First set the desired version as an environment variable in your project.


Next add this command to your Setup Commands and the script will automatically be called at build time.

Dependency Cache

Codeship automatically caches the $HOME/.virtualenv/lib/python2.7/site-packages directory between builds to optimize build performance. You can read this article to learn more about the dependency cache and how to clear it.

Need More Help?

Get in touch if you need more help, or post on Stack Overflow using the tag #Codeship.