Installing CircuitPython on ESP32
This is the tricky part. Well, the first tricky part at least. It's really just a simple matter of downloading the proper CircuitPython firmware .bin file and loading it onto the board. But since this is done over serial, it's not as easy as dragging a .uf2 file to a BOOT folder, which is the more typical CircuitPython experience. (Remember, there's no CIRCUITPY or BOOT drive on the original ESP32!)
Download Firmware
First the firmware .bin file for the board must be downloaded. These can be downloaded from the main CircuitPython site linked below - just find specific board being used:
Installing the Firmware
This must be done over serial. There are two options:
- Use the web serial browser based tool (easier, but requires at least Firefox 151 or Chrome 89 based browser).
- Use the command line based esptool.py tool (harder, unless you happen to have esptool.py installed already and you know how to use it!)
The following pages cover these options in more detail. Choose your adventure!
Page last edited May 22, 2026
Text editor powered by tinymce.