piwheels: Speedy Python package installation for the Raspberry Pi

The piwheels project is making third-party Python libraries from PyPI more easily available for Raspberry Pi users.
357 readers like this.

One of the great things about the Python programming language is PyPI, the Python Package Index, where third-party libraries are hosted, available for anyone to install and gain access to pre-existing functionality without starting from scratch. These libraries are handy utilities, written by members of the community, that aren't found within the Python standard library. But they work in much the same way—you import them into your code and have access to functions and classes you didn't write yourself.

The cross-platform problem

Many of the 150,000+ libraries hosted on PyPI are written in Python, but that's not the only option—you can write Python libraries in C, C++, or anything with Python bindings. The usual benefit of writing a library in C or C++ is speed. The NumPy project is a good example: NumPy provides highly powerful mathematical functionality for dealing with matrix operations. It is highly optimized code that allows users to write in Python but have access to speedy mathematics operations.

The problem comes when trying to distribute libraries for others to use cross-platform. The standard is to create built distributions called Python wheels. While pure Python libraries are automatically compatible cross-platform, those implemented in C/C++ must be built separately for each operating system, Python version, and system architecture. So, if a library wanted to support Windows, MacOS, and Linux, for both 32-bit and 64-bit computers, and for Python 2.7, 3.4, 3.5, and 3.6, that would require 24 different versions! Some packages do this, but others rely on users building the package from the source code, which can take a long time and can often be complex.

Raspberry Pi and Arm

While the Raspberry Pi runs Linux, it's not the same architecture as your regular PC—it's Arm, rather than Intel. That means the Linux wheels don't work, and Raspberry Pi users had to build from source—until the piwheels project came to fruition last year. Piwheels is an open source project that aims to build Raspberry Pi platform wheels for every package on PyPI.

Raspberry Pi board

Packages are natively compiled on Raspberry Pi 3 hardware and hosted in a data center provided by UK-based Mythic Beasts, which provides cloud Pis as part of its hosting service. The piwheels website hosts the wheels in a pip-compatible web server configuration so Raspberry Pi users can use them easily. Raspbian Stretch even comes preconfigured to use piwheels.org as an additional index to PyPI by default.

The piwheels stack

The piwheels project runs (almost) entirely on Raspberry Pi hardware:

  • Master
    • A Raspberry Pi web server hosts the wheel files and distributes jobs to the builder Pis.
  • Database server
    • All package information is stored in a Postgres database.
    • The master logs build attempts and downloads.
  • Builders
    • Builder Pis are given build jobs to attempt, and they communicate with the database.
    • The backlog of packages on PyPI was completed using around 20 Raspberry Pis.
    • A smaller number of Pis is required to keep up with new releases. Currently, there are three with Raspbian Jessie (Python 3.4) and two with Raspbian Stretch (Python 3.5).

The database server was originally a Raspberry Pi but was moved to another server when the database got too large.

piwheels stack

Time saved

Around 500,000 packages are downloaded from piwheels.org every month.

Every time a package is built by piwheels or downloaded by a user, its status information (including build duration) is recorded in a database. Therefore, it's possible to calculate how much time has been saved with pre-compiled packages.

In the 10 months that the service has been running, over 25 years of build time has been saved.

Great for projects

Raspberry Pi project tutorials requiring Python libraries often include warnings like "this step takes a few hours"—but that's no longer true, thanks to piwheels. Piwheels makes it easy for makers and developers to dive straight into their project and not get bogged down waiting for software to install. Amazing libraries are just a pip install away; no need to wait for compilation.

Piwheels has wheels for NumPy, SciPy, OpenCV, Keras, and even Tensorflow, Google's machine learning framework. These libraries are great for home projects, including image and facial recognition with the camera module. For inspiration, take a look at the Raspberry Pi category on PyImageSearch (which is one of my favorite Raspberry Pi blogs) to follow.

Facial recognition with Raspberry Pi camera

Read more about piwheels on the project's blog and the Raspberry Pi blog, see the source code on GitHub, and check out the piwheels website. If you want to contribute to the project, check the missing packages tag and see if you can successfully build one of them.

User profile image.
Ben is a software engineer for BBC News Labs, and formerly Raspberry Pi's Community Manager. He's into Linux, Python and all things open source! Follow Ben on Twitter @ben_nuttall.

Comments are closed.

Creative Commons LicenseThis work is licensed under a Creative Commons Attribution-Share Alike 4.0 International License.