Mac OS X – Install Tools to Program in Micropython on the ESP8266


Its easier then ever to get started with micropython developement on Mac OS X.  This howto assumes that the user is starting from zero.  Lets get started.

Install Python 3.7

Mac OS X comes with Python 2.7.  We will need Python 3 for our developement tools.  Viisit and download Python 3.7 64 bit for mac os x.

Once the download is complete open the package to install Python.  Follow the instructions in the installer to complete the installation.

Install NodeMCU Serial Driver

OS X doesn’t include a driver for the USB to serial chip used on the NodeMCU board.  Click the link below to download the driver.

Download Serial Driver

Next, unzip the download.  Open the folder and double click on the “.dmg” file.  Run the installer and follow the instructions.

Install esptool

The first tool we’ll install is a command line tool for programming ESP8266 and ESP32 based boards.  You can use this tool to write the micropython firmware to the NodeMCU.

To install esptool you’ll need to open the  Its located in the Applications -> Utilities folder.  In terminal type the following:

> pip3 install esptool

Install uPyCraft IDE

Our primary tool for micropython development will be uPyCraft.  Click on the link below to down uPyCraft.

Download uPyCraft

Open the zip file and copy uPyCraft to the Applications folder.

Download Micropython Firmware

Now visit the Micropython website and download the firmware for the ESP8266.  The link below will take you to the download page.

Micropython Download Page

Write Micropython to the NodeMCU

Liet’s write the firmware to the ESP8266.  We will do this using esptool.  Open  You will need to switch to the directory where you downloaded the bin file.  For me its the Downloads folder.  Be sure only one NodeMCU is connected to your Mac.  In terminal type the following:

> cd ~/Downloads
> esptool erase_flash
> esptool write_flash esp8266-20191220-v1.12.bin


That’s all there is to it.  You now have everything you need to develop in micropython on the Mac.


Notify of
Inline Feedbacks
View all comments