Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

RISC-V Toolchain Build Status

This provides packages to install the RISC-V toolchain on OS X using Homebrew.


First, install homebrew:

$ /bin/bash -c "$(curl -fsSL"

Get this tap:

$ brew tap riscv-software-src/riscv

Build the toolchain:

$ brew install riscv-tools

If you have macOS Monterey (12), riscv-tools will be installed from precompiled binaries. If you do not have Monterey (for x86), riscv-tools will be built from source. Note building from source will require approximately 6.5 GB for all of the source and intermediate build files. It builds with the default compiler (clang), but you can specify another compiler on the command line. For example:

$ brew install --cc=gcc-10 riscv-tools

Due to high number of dependences the RISC-V version of OpenOCD is not installed by default. If needed, it can be installed with:

$ brew install riscv-openocd


You can verify your install was successful by:

$ brew test riscv-tools

This will compile and run a hello world, so it will use all of the components (riscv-isa-sim, riscv-pk, and riscv-gnu-toolchain).


To pull in the latest version of a package, you can force an install and compile it yourself by:

$ brew reinstall --build-from-source riscv-gnu-toolchain

Supporting 32 bit Targets

By default the toolchain will enable multilib with support for 32 bit targets. To disable multilib to speed up build times and save space:

$ brew install riscv-gnu-toolchain --with-NOmultilib


To support organizational changes, we have had to make the following two naming changes which may cause issues for existing users. It can often be simplest to remove everything (uninstall with brew remove, and untap with brew untap riscv/riscv) and then to re-install (directions up top).

  • riscv -> riscv-software-src (for organization) - As long as GitHub continues to redirect the URL, this has not caused problems.
  • master -> main (for default branch name) - GitHub's branch redirection can be problematic. If you don't want to reinstall, you may be able to fix your tap with the following:
$> cd `brew --repository`/Library/Taps/riscv-software-src/homebrew-riscv
$> git branch -m master main
$> git fetch origin
$> git branch -u origin/main main
$> git remote set-head origin -a