Installing Modules

Learn how to install and remove external modules on your Arduino board.

Your MicroPython installation comes with a set of modules built-in to the firmware. If you are using any external components such as sensors, displays or neopixels, you will need to install these manually.

There are currently two methods available when installing a module on your board running MicroPython:

  • Using the
    module on your board, (download and install via Wi-Fi® connection),
  • using
    on your computer (download and install through a USB connection),

In this article, we will cover these two methods, as well as how to remove them from your board.

Please note: installing packages that contain 2-byte characters (such as emojis, Chinese symbols), is currently not supported in the Arduino Lab for MicroPython editor. You will however receive a "successful installation" response, which is a bug being investigated.

Hardware & Software Needed

Option 1: MIP

Please note that the

module requires a stable Internet connection via Wi-Fi. Installation may fail if connection is unstable.

mip is a module that allows you to install external packages/libraries/modules remotely. This module is built in to your MicroPython firmware.

To use the

module, you will however need to connect to Internet via a Wi-Fi network first. To do so, open the Arduino Lab for MicroPython editor, and run the following code:

Note: Replace "YOUR_NETWORK_NAME" and "" YOUR_NETWORK_PASSWORD" with the SSID and password for your Wi-Fi® network.

1import network
6wlan = network.WLAN(network.STA_IF)
11print("Connected to ",WIFI_NETWORK)

Once you are connected, you can use the

module to install external modules.

You can install by specifying the organisation and repository:

1import mip

Or you can specify the url to the file you want to install:


Files are added to a folder named

on your board.

There are a number of ways you can use the

method, read more about this in the MIP documentation.

Complete Example

In this example, we first connect to Wi-Fi®, and then proceed to install the `arduino-iot-cloud-py module.

1import network
2import mip
4# enter wi-fi creds
8# connect to wi-fi
9wlan = network.WLAN(network.STA_IF)
14print("Connected to ",WIFI_NETWORK)
16# install the arduino-iot-cloud module

Running this example twice will result in a

error, as you have already connected to Wi-Fi. Once you have connected once to Wi-Fi, you only need to use the

Failed Installation

Installation via

may fail due to an unstable Internet connection. If you have installed a module but you are receiving errors, make sure your Internet connection is good (your board is within reach of your router), and run the installation again.

This is typically not an issue with smaller installations (like single files), but when installing larger packages it is increased.

You can install the same module again, it will only overwrite the existing version.

Option 2: Mpremote

To install a MicroPython module on your board, you can use the Python based tool

. This requires Python to be installed. On macOS and Linux Python usually comes pre-installed. If it's not installed on your system you may download it from here. Then, to install
you can use pip:

1$ pip install mpremote


mpremote connect list
to retrieve the serial number of your device. The output will look similar to this:

1/dev/cu.usbmodem3871345733302 335B34603532 2341:055b Arduino Portenta Virtual Comm Port in HS Mode

Pass this serial number (the second value) to the install command:

1$ mpremote connect id:335B34603532 mip install github:arduino/arduino-iot-cloud-py

This will install the library and all required dependencies on the board.

Error: Certificate Verify Fail (MacOS)

On some computers, you may receive error:

1[SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed:
2unable to get local issuer certificate (_ssl.c:1002)

This indicates a problem with the Python version installed, and that it is unable to locate the SSL certificate. To work around this, navigate to your Python installation (typically Applications > Python 3.X), and run the

Install Certificates.command

Install Certificate.
Install Certificate.

Delete Files

To delete a file from your board, open the Arduino Lab for MicroPython editor, connect to your board, and click the "File" button. This will open your local files as well as your board's files.

If you want to remove a file, simply mark it and click on the trashcan icon in the top right of the file window, as the image below shows:

Removing files.
Removing files.

Suggest changes

The content on is facilitated through a public GitHub repository. If you see anything wrong, you can edit this page here.


The Arduino documentation is licensed under the Creative Commons Attribution-Share Alike 4.0 license.