Version 2.0.x Preview

Download the V2 preview.

A full rewrite of Alchitry Labs is currently underway. You can download the latest version at the link above.

This is a preview and things are likely to change/break between updates.

V2 supports Windows, Linux, and Macs.

On Macs, you can only build for the Cu using the included open-source toolchain. Both Lattice and Xilinx still do not support Macs with their build tools. This means that building for the Au is not possible.

Version 1.2.7

Alchitry Loader

Alchitry Labs now includes the Alchitry Loader as part of the install to make things simpler. This tool can be used to load .bin files directly to your board from a third-party tool.


Alchitry Labs now supports both the open source library libusb, the FTDI proprietary drivers, and direct COM port drivers (for the Mojo).

This has the advantage of no longer needing to specify a serial port for your board and you no longer need to install any drivers for the Alchitry boards on Windows or Linux!


You no longer need to install any drivers manually for Alchitry boards (see the next section for the Mojo). Windows should automatically detect and load the proper drivers for your board.

If you were using a previous version of Alchitry Labs, you can now remove winUSB. To do this, open the Device Manager (with your board plugged in) and scroll down to "Universal Serial Bus devices."

Here you should see two entries for your board. Right click on one of them and choose "Uninstall device."

In the dialog that pops up, make sure "Delete the driver software for this device" is checked and click "Uninstall." Repeat this for the second entry.

Now unplug and replug in your board.

Legacy Drivers (COM port)

If you are using a Mojo, you need to install the serial port drivers by running the file named dpinst-amd64.exe which can be found where you installed Alchitry Labs or in the Windows files (not the installer).


You likely won't have to do anything. The drivers for libusb are generally included with your distribution and things will probably just work.

If you run into permission problems, you can copy the udev rules files from the driver folder into /etc/udev/rules.d/. These will give access to the boards to the "dialup" group.


To build projects for the Au you need to install Vivado (WebPACK, aka free).

To build projects for the Cu you need to install iCEcube2 (bottom of the page).

If you are building with iCEcube2 for the Cu, you will need to point the IDE to your license file for iCEcube2. You can get a license here.

You can also use the open source project IceStorm to build for the Cu.

To build for the Mojo you need to install ISE.