MicroPythonOS Logo

Effortlessly install MicroPythonOS on your microcontroller.

Install MicroPythonOS

Click the button below to flash MicroPythonOS 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? Get one of the supported devices.
Or check out the docs to see how you can run it on your desktop PC.

Select Version


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

⚠️ Already running MicroPythonOS? This can erase your data.

This installer performs a clean install, not an update:

  • If you select "Erase device" during installation, your storage partition — installed apps, WiFi credentials, wallet-display configs, Nostr keys/npub and all other user data — will certainly be erased.
  • Even without erasing, the new version might use a different partition layout than the one on your device (this can happen from time to time as MicroPythonOS evolves). In that case your storage partition is reformatted on first boot, without any prompt.
  • The supported way to update an installed device is the built-in OSUpdate app (over-the-air update), which preserves all your data — see Updating.
  • Just like for any electronics device: back up important files before re-installing the software.

Your browser does not support installing things on ESP devices. Use Google Chrome or Microsoft Edge.

How to Use

  1. Connect the device to your computer via USB.
  2. Put it in bootloader mode (USB device ID 303a:1001):
    • if it already has MicroPythonOS installed, go to Settings - Restart to Bootloader
    • to force bootloader mode, keep the IO0 (BOOT) button pressed while plugging in the USB cable
    • or keep the IO0 (BOOT) button pressed 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 pop-up instructions to start the installation.
  7. After it's done, you may need to press the "RST" button on your device to restart normally.