MicroPythonOS

Effortlessly install MicroPythonOS on your microcontroller.

Install MicroPythonOS

Click the button below to flash MicroPythonOS firmware onto your ESP device using WebSerial. Ensure your device is connected via USB and you're using a supported browser (e.g., Chrome or Edge).

Don't have a device yet? Buy a supported one, like the Waveshare ESP32-S3-Touch-LCD-2. Or check out the docs to see how you can run it on your desktop PC.


These old releases are only here for archival, reverting, testing or troubleshooting.

How to Use

  1. Connect the device to your computer via USB.
  2. Put it in bootloader mode:
    • if it already has MicroPythonOS installed, go to Settings - Restart to Bootloader
    • if it's fresh from the factory, it's probably already good
    • if not, try pressing the IO0 (BOOT) button while plugging in the USB cable
    • if not, press the IO0 (BOOT) button while briefly pressing the reset button
    It should show up as "303a:1001 Espressif USB JTAG/serial debug unit Systems Espressif Device" instead of a regular MicroPython REPL serial device like "303a:4001 Espressif Systems Espressif Device".
  3. After connecting it to your computer via USB, start up a webbrowser with WebSerial support like Chrome, Brave or Edge. If the browser was already running, you probably need to restart it.
  4. Click the "Install" button above.
  5. Select your device from the browser's serial port prompt.
  6. Follow the instructions to start the installation.
  7. After it's done, you may need to press the "RST" button on your device to restart normally.