Skip to content

MicroPython firmware for Pybricks-compatible devices.

License

Notifications You must be signed in to change notification settings

pybricks/pybricks-micropython

Folders and files

NameName
Last commit message
Last commit date
Sep 17, 2024
Oct 19, 2024
Dec 5, 2024
Dec 5, 2024
Oct 2, 2024
Oct 15, 2024
Dec 10, 2024
Oct 2, 2024
Mar 4, 2024
Mar 23, 2021
Apr 22, 2021
Jul 5, 2022
May 5, 2022
Dec 22, 2023
Dec 22, 2023
Aug 30, 2021
Dec 10, 2024
Aug 24, 2024
Feb 10, 2024
Apr 27, 2023
Feb 26, 2024
Aug 11, 2024
Jul 2, 2020
Aug 11, 2024
Apr 27, 2023
Sep 23, 2020
Dec 21, 2021
Feb 28, 2023

Repository files navigation

Quick links

Issues & discussion

Pybricks

Pybricks brings Python-like coding to programmable LEGO bricks, and transforms remote-controlled smart hubs into truly autonomous robots.

Pybricks builds on MicroPython, which is an efficient Python implementation that runs on microcontrollers. Pybricks expands MicroPython with new powerful drivers for LEGO devices including motors and sensors. It also adds the pybricks package, which makes it easy for end-users to access those devices and all the features of the smart hubs.

Are you a beginning user?

Start by visiting our website and the documentation.

Are you a developer or just super curious?

Read on!

Supported Programmable Bricks & Hubs

All modern Powered Up hubs can be used with Pybricks Code, our online IDE:

  • LEGO Technic Hub
  • LEGO BOOST Move Hub
  • LEGO City Hub
  • LEGO SPIKE Prime Hub
  • LEGO SPIKE Essential Hub
  • LEGO MINDSTORMS Robot Inventor Hub

We also support Pybricks v2.x on MINDSTORMS EV3. The community-supported version comes preinstalled with the latest ev3dev image. It is also available via the LEGO Education website.

Development

Most Pybricks users will not need to do anything with this source code. Pybricks Code always gives you the latest stable firmware. You can even try the beta release to check out the latest and greatest features.

But since you're reading this, you might be interested to build the code yourself, or start tweaking and hacking. Check out the contributor's guide to get started.

Pybricks and Upstream MicroPython

The Pybricks authors are actively contributing to upstream MicroPython instead of forking it into a whole new project. In essence, Pybricks just adds a family of ports.

To streamline development and releases, we do maintain a fork of micropython here. This adds a few minor patches that haven't made it upstream yet. Every once in a while, that repository gets rebased with all the latest and greatest that upstream micropython has to offer.

Summing up:

What about all the other repositories?

Pybricks includes not just firmware for each LEGO hub, but also various tools, documentation, and fun projects. Here's an overview of the other repositories:

  • pybricks-api: This is the Pybricks user API. It documents the pybricks package that comes preinstalled in our firmware. This repository doesn't contain any real code. The real package is written in C and baked into the firmware. This repo just helps us design and document the user Python API without getting into too much implementation details. Don't want to build it? View the web version here.
  • pybricks-projects: This is a broad collection of end-user MicroPython scripts that you can run! This includes example snippets and projects for official LEGO models and custom made ones.
  • pybricks-code: This is the source code for the Pybricks Code online IDE.

What about the other stuff in /bricks?

Like MicroPython, Pybricks can run on just about every device that lets you update the firmware. And we could not resist doing just that, so there's more than just the bricks/hubs mentioned above. But getting to a point where it is easy to use for everyday users takes quite a bit more work, so not all bricks in /bricks will be supported officially for now. Be sure to join the discussion on our issue tracker to share your thoughts on these new ports.

Differences with other LEGO MicroPython Implementations

Read more about the differences on the Pybricks about page.

How can I help?

If you've got any of the hubs listed above, the best way to help right now is to try out the beta release of Pybricks Code. You may run into issues or bugs. Please let us know by opening an issue. Thanks!

If you enjoy using Pybricks, please consider sponsoring the project.