We assume you already have Python 3 and brew available on your Mac. Thankfully, setup on MacOS X is not so bad!

Note: If you are running VMWare Fusion on MacOS, then you can also try the Windows install process.

Install libusb

Start by installing libusb with

brew install libusb

Install PySerial

Type pip3 install pyserial

Install hidapi

Type pip3 install hidapi

Do NOT pip install hid. That is a different library that should NOT be installed.

Install Blinka

Then pip3 install adafruit-blinka

Set Environment Variable 

You'll need to set this variable every time before running CircuitPython code. To do this, we set the environment variable BLINKA_U2IF.

You can set the variable by running:

export BLINKA_U2IF="1"

Run the sanity checks.

Now move on to the Post Install Checks section and run the commands there to make sure everything is installed correctly.

This guide was first published on May 01, 2021. It was last updated on Mar 08, 2024.

This page (Mac OSX) was last updated on Mar 08, 2024.

Text editor powered by tinymce.