Skip to content


Subversion checkout URL

You can clone with
Download ZIP
GPGPU processor architecture
C C++ SystemVerilog Assembly Python Makefile Other
Branch: master

Nyuzi Processor

Build Status Chat at

Nyuzi is an experimental multicore GPGPU processor. It supports vector floating point, hardware multithreading, and cache coherence. The SystemVerilog-based hardware implementation is synthesizable and runs on FPGA. This project also includes an LLVM-based C++ toolchain, tests, and many other tools. It is useful for microarchitecture experimentation, performance modeling, and parallel software development.

I have attempted to make this easy to set up and hack on. It uses free and mostly open source tools. Contributions are welcome, please see CONTRIBUTING for more details.

Mailing list:!forum/nyuzi-processor-dev
License: Apache 2.0

Getting Started

The following instructions explain how to set up the Nyuzi development environment, including the emulator and cycle-accurate hardware simulator. This allows both hardware and software development without an FPGA. These instructions assume you have cloned this repo on your local machine and have a shell open in the top directory.

If you have problems getting this running, feel free to send a message to the mailing list or Gitter (links above).

Install Prerequisites

Linux (Ubuntu)

This requires Ubuntu 14 or later to get the proper package versions. It should work for other distributions, but you will probably need to change some package names.

sudo apt-get -y install cmake make gcc g++ bison flex python perl emacs curl openjdk-7-jdk swig zlib1g-dev python-dev libxml2-dev libedit-dev ncurses-dev libsdl2-dev gtkwave imagemagick 

Emacs is used for verilog-mode AUTO macros. The makefile executes this operation in batch mode


These instructions assume Mavericks or later. If you don't have XCode, install the command line tools like this:

xcode-select --install

The next command installs the remaining packages, assuming you've installed MacPorts:

sudo port install cmake bison swig swig-python imagemagick libsdl2 curl emacs

You may optionally install GTKWave for analyzing waveform files.


I have not tested this on Windows. Many of the libraries are cross platform, so it should be possible to port it. But the easiest route is probably to run Linux under a virtual machine like VirtualBox.

Build (Linux & MacOS)

Download and build Verilator as follows (although some Linux package managers have it, it is out of date):

cd tools
curl | tar xz
cd verilator-3.876/ 
sudo make install
cd ../..

Download and build the Nyuzi toolchain as follows (This clones my repo. If you want to use your own fork, change the clone URL):

git clone tools/NyuziToolchain
cd tools/NyuziToolchain
mkdir build
cd build
cmake .. 
sudo make install
cd ../../..

Build remaining tools and hardware model. Run unit tests.

make test

What next?

Sample applications are available in software/apps. You can run these in the emulator by typing 'make run' (some need 3rd party data files, details are in the READMEs in those directories).

For example, this will render a 3D model:

cd software/apps/sceneview
make run

Running on FPGA

See instructions in hardware/fpga/de2-115/

Something went wrong with that request. Please try again.