Random Nerd Tutorials

Install uPyCraft IDE – Mac OS X Instructions


There are different firmwares that you can use to program the ESP32 and ESP8266 boards. If you want to program the ESP32 or ESP8266 board using the MicroPython firmware, we recommend using uPyCraft IDE. uPyCraft IDE runs in any major operating system. In this tutorial we’ll show you how to install the uPyCraft IDE for MicroPython on Mac OS X.

If you’re using a different operating system, make sure you follow the right guide:

After installing uPyCraft IDE in your computer, we recommend reading: Getting Started with MicroPython on ESP32 and ESP8266.

Installing Python 3.X – Mac OS X

Before installing the uPyCraft IDE, make sure you have the latest version of Python 3.X installed in your computer. If you don’t, follow the next instructions to install Python 3.X with the brew command. Open a terminal window and type the next command:

$ brew install python3

Wait a few seconds while the installation procedure is completed.

Allowing Apps Downloaded to Run

Since uPyCraft IDE is open source and downloaded from the Internet, it’s not a verified app in the App Store. For security reasons, Mac OS X blocks unknown apps to run on your computer. Follow these next instructions to enable any downloaded software to run in your Mac.

1. Open the “System Preferences...” menu.

2. Open the “Security & Privacy” menu.

3. At the bottom left corner, click the lock icon to modify your “Security & Privacy” settings:

4. Type your username/password and click the “Unlock” button.


5. Finally, select the option “Allow apps downloaded from: Anywhere“.

That’s it, you can close that window.

Installing uPyCraft IDE – Mac OS X

As mentioned before, for this tutorial we’ll be using uPyCraft IDE to program the ESP32 or ESP8266 boards using the MicroPython firmware. In our opinion, uPyCraft IDE is the easiest way of programming ESP based boards with MicroPython at the moment.

You can learn more about uPyCraft IDE on their GitHub repository or explore the uPyCraft IDE source code.

Downloading uPyCraft IDE for Mac OS X

Click here to download uPyCraft IDE for Mac OS X or go to this link https://randomnerdtutorials.com/uPyCraftMac. After a few seconds you should see a similar file (uPyCraft_mac_VX.zip) in your Downloads folder:

Unzip the uPyCraft_mac_VX.zip and you should see a new file called uPyCraft. Double-click the uPyCraft file:

Press the “Open” button to actually run it:

Here’s what should open:

We’ll be using this software to flash our ESP based boards with MicroPython firmware as well as to program the boards.

Follow the next tutorial to flash your ESP boards with the MicroPyhton firmware:

Wrapping Up

We hope you’ve found this tutorial useful. This is a quick guide that shows how to install uPyCraft IDE on Mac OS X. If you have a different operating system, read one of the following guides:

Learn more about MicroPython here: Getting Started with MicroPython on ESP32 and ESP8266.

Thanks for reading. If you liked this post, you might like our next ones, so make sure you subscribe to the RNT blog and download our free electronics eBooks.

MicroPython Programming with ESP32/ESP8266 eBook

Learn how to program the ESP boards with MicroPython, including projects, tips, and tricks! The registrations are open for a limited time, so SIGN UP NOW »

Recommended Resources

Home Automation using ESP8266 »
Build IoT projects and home automation gadgets with the ESP8266 Wi-Fi module.

Build a Home Automation System »
Learn how to build a automation system using open-source hardware and software from scratch.

Arduino Step-by-Step Projects »
Build 25 cool Arduino projects with our course even with no prior experience!

Leave a Comment:

⏰ Registrations are open for "MicroPython Programming with ESP32 and ESP8266" eBook