QuCumber only supports Python 3 (specifically, 3.6 and up), not Python 2. If you are using Python 2, please update! You may also want to install PyTorch (, if you have not already.

If you’re running a reasonably up-to-date Linux or macOS system, PyTorch should be installed automatically when you install QuCumber with pip.


Windows 10 is recommended. PyTorch is required (following One way for getting PyTorch is having Anaconda installed first and using the 64-bit graphical installer (

Before you install Anaconda, make sure to have a LaTeX distribution installed, for example MiKTeX (, as Matplotlib libraries require LaTeX for nice visualization in Python.

After the Anaconda installation, follow specific instructions on to get the correct installation command for PyTorch, which is CUDA version dependent. For example, if your system does not have a GPU card, you will need the CPU version:

conda install pytorch torchvision cpuonly -c pytorch

To install QuCumber on Anaconda, start the Anaconda prompt, or navigate to the directory (through command prompt) where pip.exe is installed (usually C:\Python\Scripts\pip.exe) and then type:

pip.exe install qucumber

Linux / macOS

Open up a terminal, then type:

pip install qucumber


Navigate to the qucumber page on GitHub ( and clone the repository by typing:

git clone

Navigate to the main directory and type:

python install