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.
- 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
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:
- Go to Pybricks Code.
- Press and hold the hub button. Wait for a blinking pink light.
- While you hold it, click the firmware update button.
- Select the LEGO Bootloader and click Pair.
- Wait until the light turns off, and then blinks red/green/blue.
- Release the button and wait for the installation to finish.
These steps are summarized in this video:
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:
- Open the settings tab with the icon.
- Activate the Include current program switch.
- Update the firmware as you did before. Now, your current program will be included.
- Now can start and stop your program with the green button. No connection required!
- 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.
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 try the latest beta version of our app. This version gets more frequent updates. It’s possible we’ve fixed your issue already.
You can refresh the app by pressing Ctrl + F5.
If connection issues continue to persist, please describe the problem on our support page.
Trying out new features with Pybricks Beta (easy)
Some features may not work yet, and they may still change before the final release.
If you try the beta version, please give us feedback!
Installing the latest build (advanced)
This section is only intended for advanced users who want to try the very latest features or fixes. Many features may not work. To revert to a stable or beta version, just re-install the firmware as you normally would.
Pybricks automatically provides the latest stable and tested firmware.
To get the most recent firmware build, log in to GitHub and go to
our latest builds.
Click on the desired build and scroll down to
Download the firmware ZIP archive for your hub. To install it, drag the ZIP
file onto the firmware button in Pybricks Code (instead of just
clicking the button). The update now
proceeds as usual.
To confirm that you’ve installed the version you wanted, run the following script on your hub:
from pybricks import version print(version)