VUnit supports VHDL (93, 2002, 2008 and 2019), Verilog and (experimentally) SystemVerilog; and it is known to work on GNU/Linux, Windows and Mac OS; on x86, x64, armv7 and aarch64. Full VUnit functionality requires Python (3.6 or higher) and a simulator supported by the VUnit Python test runner (see list below). However, VUnit can run with limited functionality entirely within VHDL using the VHDL test runner.



  • Aldec Riviera-PRO: Tested with Riviera-PRO 2015.06, 2015.10, 2016.02, 2016.10 (x64/x86).

  • Aldec Active-HDL: Tested with Active-HDL 9.3, 10.1, 10.2, 10.3 (x64/x86)

  • GHDL

    • Works with versions >= 0.33 (Note: GHDL is a rolling project, it is therefore recommended to use the latest nightly release tarball.)

    • Tested with LLVM and mcode backends, gcc backend might work aswell.

    • Integrated support for using GTKWave to view waveforms.

VHDL or SystemVerilog


  • Cadence Incisive (Experimental)

    • Community contribution by Colin Marquardt. VUnit maintainers do not have access to this simulator to verify the functionality.

    • Run to remove VHDL constructs that are not compatible with Incisive

Using the Python Package Manager

The recommended way to get VUnit is to install the latest stable release via pip:

> pip install vunit_hdl

Once installed, VUnit may be updated to new versions via a similar method:

> pip install -U vunit_hdl

Using the Development Version

Start by cloning our GIT repository on GitHub:

git clone --recurse-submodules

The --recurse-submodules option initializes OSVVM which is included as a submodule in the VUnit repository.

To be able to import VUnit in your script you need to make it visible to Python or else the following error occurs.

Traceback (most recent call last):
   File "", line 2, in <module>
     from vunit import VUnit
ImportError: No module named vunit

There are three methods to make VUnit importable in your script.:

  1. Install it in your Python environment using:

    > python install
  2. Set the PYTHONPATH environment variable to include the path to the VUnit repository root directory. Note that you shouldn’t point to the vunit directory within the root directory.

  3. Add the following to your file before the import vunit statement:

    import sys
    import vunit

For VUnit Developers

For those interested in development of VUnit, it is best to install VUnit so that the sources from git are installed in-place instead of to the Python site-packages directory. This can be achieved by using the -e flag with pip, or the develop option with, or setting the PYTHONPATH environment variable.

> git clone
> cd vunit

> python develop
> pip install -e .

By installing VUnit in this manner, the git sources can be edited directly in your workspace while the VUnit package is still globally available in your Python environment.