Installing the Development Version


If you want to follow the instructions on this page, make sure you are reading its latest version.

Once you install the development version, you should keep reading the matching documentation.

The development version of cocotb has different prerequisites than the stable version:

  • Python 3.6+

  • Python development packages

  • GCC 4.8.1+, Clang 3.3+ or Microsoft Visual C++ 14.21+ and associated development packages

  • GNU Make

  • A Verilog or VHDL simulator, depending on your RTL source code

Please refer to Installation of Prerequisites for details.

The development version of cocotb can be installed by running

pip install git+


If your user does not have permissions to install cocotb using the instructions above, try adding the --user option to pip (see the pip documentation).


pip may belong to a different Python installation to what you expect. Use pip -V to check. If this prints “(python 2.7)”, use pip3 or python3 -m pip in place of pip in the command shown.

After installation, you should be able to execute cocotb-config. If it is not found, you need to append its location to the PATH environment variable. This may happen when you use the --user option to pip, in which case the location is documented here.