How to Install the Chaos Toolkit

You can either install the chaostoolkit command line or run it from a container.

The former expects Python 3.5+ properly setup on your machine while the latter expects a tool implementing the OCI 1.0 specification, such as Docker or runc.

Python Requirements

The chaostoolkit CLI is implemented in Python 3 and this require a working Python installation to run. It officially supports Python 3.5+. It has only been tested against CPython.

Install Python

Install Python for your system:

On MacOSX:

$ brew install python3

On Debian/Ubuntu:

$ sudo apt-get install python3 python3-venv

On CentOS:

$ sudo yum -y install
$ sudo yum -y install python35u

Notice, on CentOS, the Python 3.5 binary is named python3.5 rather than python3 as other systems.

On Windows:

Download the latest binary installer from the Python website.

Create a virtual environment

Dependencies can be installed for your system via its package management but, more likely, you will want to install them yourself in a local virtual environment.

$ python3 -m venv ~/.venvs/chaostk

Make sure to always activate your virtual environment before using it:

$ source  ~/.venvs/chaostk/bin/activate


You may want to use virtualenvwrapper to make this process much nicer.

Install the CLI

Install chaostoolkit in the virtual environment as follows:

(chaostk) $ pip install chaostoolkit

You can verify the command was installed by running:

(chaostk) $ chaos --version

Download the container image

You can run the chaostoolkit from a container rather than install it.

For instance, using Docker, you can pull the chaostoolkit image:

$ docker pull chaostoolkit/chaostoolkit