How to Install uPyCraft IDE on a Linux Ubuntu

There are different firmware that you can use to program the ESP32 and ESP8266 devices. If you wish to program the ESP32 or ESP8266 board using the MicroPython firmware, we suggest using uPyCraft IDE. uPyCraft IDE runs on every major operating system. In this tutorial, we’ll show you how to install uPyCraft IDE on a Linux Ubuntu 16.04.

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

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

Installing Python 3.X – Linux Ubuntu

Before Python 3.X is set up on your PC, install the uPyCraft IDE. Follow the next instructions to install Python 3.X if you don't. To install Python 3 with pip, use the following command:

$ sudo apt install python3 python3-pip
Installing Python3 pip Linux Ubuntu for uPyCraft IDE

Installing uPyCraft IDE – Linux Ubuntu 16.04

The ESP32 or ESP8266 boards will be programmed for this tutorial using the MicroPython firmware and the uPyCraft IDE. In our view, the uPyCraft IDE was the simplest way to program ESP-based boards with MicroPython at the time.

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

Important: At the time of writing this guide, uPyCraft IDE was only tested on Linux Ubuntu 16.04. If you want to run it on a different Ubuntu version or Linux distribution, we recommend using uPyCraft IDE source code and compiling the software yourself.

Downloading uPyCraft IDE for Linux Ubuntu 16.04

Click here to download uPyCraft IDE for Linux Ubuntu 16.04 After a few seconds, you should see a similar file (uPyCraft linux in your Downloads folder:

Open your Terminal window, navigate to your Downloads folder, and list all the files:

$ cd Downloads
$ ls -l

You should see a new file called (uPyCraft_linux_V1.0) after unzipping (uPyCraft linux You need to make that file executable with the following command:

$ chmod +x uPyCraft_linux_V1.X

Then, to open/run the uPyCraft IDE software, type the next command:

$ ./uPyCraft_linux_V1.X
Open uPyCraft IDE Linux Ubuntu

We'll be programming our ESP-based boards as well as flashing them with MicroPython firmware using this software.

uPyCraft IDE Linux Ubuntu window

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


This tutorial should be helpful to you, we hope. This quick tutorial shows you how to install uPyCraft IDE on a Linux Ubuntu. Read one of the following guidelines if you have a different operating system:

If you like ESP8266, you may also like:

We hope you find this tutorial useful. Thanks for reading.

Oh hi there It’s nice to meet you.

Sign up to receive awesome content in your inbox, every month.

We don’t spam! Read our privacy policy for more info.

Leave a Reply

Your email address will not be published. Required fields are marked *

Developing IoT Projects with ESP32

Automate your home or business with inexpensive Wi-Fi devices

ESP8266 Home Automation Projects

Leverage the power of this tiny WiFi chip to build exciting smart home projects