Installing Pybricks on the Technic Hub, BOOST Move Hub, and City Hub

Powered Up hubs

This page shows how you can install Pybricks on the BOOST Move Hub, the City Hub, and the Technic Hub using the Pybricks Code interface.

You can reinstall the original firmware at any time using the official Powered Up app.

Requirements

  • A BOOST Move Hub, City Hub, or Technic Hub.
  • A Windows, Mac, Linux, or Android device.
  • Bluetooth Low Energy (BLE). Make sure that Bluetooth is on.

If you don’t have BLE, the coding interface will inform you during the installation step. In that case, you can try using a low-cost USB Bluetooth Dongle that supports Bluetooth Low Energy.

Installing a compatible browser

Writing Pybricks programs requires a web browser with web Bluetooth functionality, such as:

If you use Linux, enable Experimental Web Platform features on the chrome://flags/ page. It’s already enabled on Windows and Mac.

Installing the Pybricks firmware

Before you begin, turn the hub off. The update works best with fresh batteries. If you use the City Hub, you must unplug all motors and sensors. Follow these steps:

  1. Go to Pybricks Code.
  2. Press and hold the hub button. Wait for a blinking pink light.
  3. While you hold it, click the firmware update button.
  4. Select the LEGO Bootloader and click Pair.
  5. Wait until the light turns off, and then blinks red/green/blue.
  6. Release the button and wait for the installation to finish.

These steps are summarized in this video:


Start coding

With the firmware in place, you’re ready to start coding. Check out our guide on the next page.

Additional tips & tricks

The sections below provide some additional tips to make using these hubs even easier. You’ll also learn how to restore the original firmware.

Saving a program on the hub

The Move Hub, City Hub, and Technic Hub do not have separate storage space for user programs. This means your program is erased after it is done running. Fortunately, you can still save one program on the hub, by including it in the firmware. To do so:

  1. Open the settings tab with the icon.
  2. Activate the Include current program switch.
  3. Update the firmware as you did before. Now, your current program will be included.
  4. Now can start and stop your program with the green button. No connection required!
  5. You can still download and run new programs with the run button as usual.

This is a bit of a slow process to do each time. We recommend to use the run button to run your code most of the time. When you are happy with your final program, follow the steps above to save it on the hub.

Restoring the original firmware

Pybricks uses the same update procedure as the LEGO apps. The only difference is which firmware file we upload. This means you can go back to the original firmware any time. As shown in the video below, just put the hub in update mode and connect using a LEGO app.


This video shows the Powered Up app in create mode. It has firmware for all hubs. As usual, you may need to restart the app to detect the hub. If it fails, try again with fresh batteries.

Troubleshooting connectivity issues

When connectivity issues arise, you’ll usually see a notification popup that describes the problem. Be sure to follow the indicated instructions. If that does not help, follow the instructions below.

  • If the firmware is already installed but you are unable to run programs, please reinstall the firmware to ensure you have the latest version.

  • You should not attempt to connect to the hub via your computer’s settings menu. If you already did, just remove the hub from there and try again.

  • You can refresh the app by pressing Ctrl + F5.

  • If connection issues continue to persist, please describe the problem on our support page.

Installing the latest build

This section is only intended for developers who want to try the latest features. Some features may not work. To revert to a stable version, just install the firmware as you normally would.

Pybricks Code automatically provides the latest stable and tested firmware. To get a more recent version, log in to GitHub and go to our latest builds. Click on the desired build and go to Artifacts. Download the firmware ZIP archive for your hub. To install it, drag this file onto the firmware update button in Pybricks Code. The update now proceeds as usual.