Mac OS X Installation


Open your bash terminal and paste this into the prompt:

/usr/bin/ruby -e "$(curl -fsSL"

This snippet is taken directly from brew’s website. The script will guide you through the installation.


libusb is required by the chipwhisperer software to communicate with the board. You can install it using brew:

brew install libusb


The best way to install Python on Mac is in a Python virtualenv. The steps for this are found at A quick summary is:

brew install pyenv
pyenv install 3.9.5
pyenv global 3.9.5
echo -e 'if command -v pyenv 1>/dev/null 2>&1; then\n  eval "$(pyenv init -)"\nfi' >> ~/.zshrc

Then launch a new terminal and run

python --version

and make sure it reports that you’re using Python 3.9.5.


The compilers are also available on Mac OSx. The ARM compiler can be found on the ARM website. If needed, the AVR compiler can be installed as well using:

brew tap osx-cross/avr
brew install avr-gcc

This brew install does not work for some older versions of Mac OS X. You will have to find a different way to install the compilers.

Mac M1 Notes

ChipWhisperer is compatable with Mac M1; however, due to the M1’s different architecture, as well as its x86 emulation, you need to manually install libusb1 and ensure that the architecture for libusb1 matches the architecture for Python.

See for more information.