Getting a bootloader and CircuitPython onto an Espressif board can be a complicated process, involving multiple downloads and software tools. But there's an easier way. The Espressif boards on the board download pages on circuitpython.org provide a button labelled OPEN INSTALLER. Clicking this button invokes the Web Firmware Installer. This easy-to-use step-by-step tool can:
- Erase the flash on a board
- Install the TinyUF2 bootloader (if the board supports it)
- Install CircuitPython
- Fill in settings.toml with your desired network settings
This Learn Guide describes how to the use the tool. Go to the page that describes which board you have:
- Boards with Full USB Support: Espressif ESP32-S2, ESP32-S3
- Serial-Only Boards: Espressif ESP32, ESP32-C2, ESP32-C3, ESP32-C6, ESP32-H2
Page last edited August 05, 2025
Text editor powered by tinymce.