How to Install the Chaos Toolkit¶

Python Requirements¶

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

Install Python¶

Install Python for your system:

On MacOS X:

brew install python3

On Debian/Ubuntu:

sudo apt-get install python3 python3-venv

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

Install the CLI¶

Install chaostoolkit in the virtual environment as follows:

pip install -U chaostoolkit

You can verify the command was installed by running:

chaos --version

Install Extensions¶

At this stage, you have installed the chaos command line and its core library. To fully enjoy the Chaos Toolkit, you will also want to install extensions for the various facets of your journey into Chaos Engineering.