Installing Mu Editor

Mu is a simple code editor that works with the Adafruit CircuitPython boards. It's written in Python and works on Windows, MacOS, Linux and Raspberry Pi. The serial console is built right in so you get immediate feedback from your board's serial output!

Mu is our recommended editor - please use it (unless you are an experienced coder with a favorite editor already!)

Installing Mu for Windows or Mac OS X

To install Mu for Windows, follow these steps:

Click the link above to download the latest version of Mu. If you are using Windows, you must be running Windows 7 or higher. For Mac OS X you must be running 10.11 (El Capitan) or higher (Mac users with lower versions can try the Linux instructions below, but YMMV)


Download and save the file to your desktop or wherever is handy.


Double-click the file to open Mu. You're ready to go!

Installing Mu for Linux

Each Linux distro is a little different, so use this as a guideline! These instructions will also work for Mac OS X, but you'll want to use brew instead of apt-get

  1. Mu require python version 3. If you haven't installed python yet, do so via your command line using something like sudo apt-get install python3
  2. You'll also need pip3 (or pip if you only have python3 installed) - try running pip3 --version. If that didn't work, you ran sudo apt-get install python3-pip
  3. Finally, run pip3 install mu_editor
  4. You can now run mu directly from the command line

Using Mu

The first time you start Mu, you will be prompted to select your 'mode' - you can always change your mind later. For now please select Adafruit!

The current mode is displayed in the lower right corner of the window, next to the "gear" icon. If the mode says "Microbit" or something else, click on that and then choose "Adafruit" in the dialog box that appears.

Mu attempts to auto-detect your board, so please plug in your CircuitPython device and make sure it shows up as a CIRCUITPY drive before starting Mu

Now you're ready to code! Lets keep going....

Last updated on 2018-04-13 at 11.50.39 AM Published on 2017-05-03 at 04.54.54 PM