RISC-V Toolchain [](https://github.com/riscv/homebrew-riscv/actions/workflows/macos-ci.yml)

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

Installation

First, install homebrew:

$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Get this tap:

$ brew tap riscv-software-src/riscv
$ brew trust riscv-software-src/riscv

Build the toolchain:

$ brew install riscv-tools

If you have macOS Sequoia (15), riscv-tools will be installed from precompiled binaries. If you do not have Sequoia, 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-16 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

Testing

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).

Updating

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

Troubleshooting

The use of trust is now required since this is a 3rd party tap due to an update from brew.