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 with the Plotter for Mac OS

The Mu version linked above does not have the plotter included. So, if you'd like to use the plotter, follow these steps to get the latest version of Mu installed!

  1. Install Homebrew. Paste the line under "Install Homebrew" into the Terminal app.
  2. Once Homebrew is installed, type into your Terminal app: brew install python3
  3. Once Python3 is installed, type into your Terminal app: pip3 install mu-editor
  4. That's it! Now when you'd like to use Mu, open the Terminal application and type: mu

Installing Mu for Linux

Each Linux distro is a little different, so use this as a guideline!

  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....

Mu Packages

Mu is currently being developed. So there are lots of changes being made! Current versions are available from links at the bottom of this page. However, use at your own risk! These are not stable versions and come with no guarantees of working.

Last updated on May 09, 2018 Published on May 03, 2017