MatchZoo is dependent on Python 3. It is recommended that you use Python 3.6 or greater, which can be installed either through the Anaconda package manager (see below), Homebrew, or the Python website.

Package Manager

MatchZoo can be installed through two package Manager, Anaconda or pip. Anaconda is the recommended package manager as it will provide you all of the MatchZoo dependencies in one, sandboxed install, including Python.


To install Anaconda, you can download graphical installer or use the command-line installer. If you use the command-line installer, you can right-click on the installer link, select Copy Link Address, and then use the following commands:

   # The version of Anaconda may be different depending on when you are installing`
   curl -O
   # and follow the prompts. The defaults are generally good.`


If you installed Python via Homebrew or the Python website, pip was installed with it. If you installed Python 3.x, then you will be using the command pip3.

Tip: If you want to use just the command pip, instead of pip3, you can symlink pip to the pip3 binary.



To install MatchZoo via Anaconda, use the following conda command:

   conda install matchzoo-py


To install MatchZoo via pip, use one of the following two commands, depending on your Python version:

   pip install matchzoo-py
   # Python 3.x
   pip3 install matchzoo-py

Building from source

Install MatchZoo-py from the Github source:

   git clone
   cd MatchZoo-py
   python install