# piwheels

**Repository Path**: mirrors_tjguk/piwheels

## Basic Information

- **Project Name**: piwheels
- **Description**: Python package repository providing wheels (pre-built binaries) for Raspberry Pi
- **Primary Language**: Unknown
- **License**: BSD-3-Clause
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-11-23
- **Last Updated**: 2026-05-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

========
piwheels
========

piwheels is Python package repository providing `wheels`_ (pre-built binaries)
for the ARMv6 and ARMv7 architectures used by `Raspberry Pi`_.

This repository contains the source code for building armv6 and armv7 wheels
for packages found on `PyPI`_, and the project's future will be discussed in
`GitHub issues`_.

The piwheels service is hosted at `www.piwheels.org`_.

.. _wheels: https://packaging.python.org/wheel_egg/
.. _Raspberry Pi: https://www.raspberrypi.org/
.. _PyPI: https://pypi.python.org/pypi
.. _GitHub issues: https://github.com/bennuttall/piwheels/issues
.. _www.piwheels.org: https://www.piwheels.org/


Usage
-----

`Raspbian Stretch`_ includes configuration for pip to use piwheels by default.
If you're using an alternate distribution, make sure you have pip v9, and you
can use piwheels by placing the following lines in ``/etc/pip.conf``::

    [global]
    extra-index-url=https://www.piwheels.org/simple

Alternatively, install from piwheels explicitly with ``-i`` or
``--index-url``::

    sudo pip3 install numpy -i https://www.piwheels.org/simple

or ::

    sudo pip3 install numpy --index-url https://www.piwheels.org/simple

Or as an additional index::

    sudo pip3 install numpy --extra-index-url https://www.piwheels.org/simple

.. _Raspbian Stretch: https://www.raspberrypi.org/downloads/raspbian/


Support
-------

piwheels provides wheels which are compatible with all Raspberry Pi models (Pi
3, Pi 2, Pi 1 and Pi Zero), for Python 3.4 and 3.5. We plan to add support for
Python 3.6 and 2.7.


Issues
------

If you find any issues with packages installed from piwheels, please open a new
issue in `GitHub issues`_, providing as much detail as possible.


Contributing
------------

See the `contributing guidelines`_ for more information.

.. _contributing guidelines: CONTRIBUTING.md


Further reading
---------------

- `Wheel vs Egg <https://packaging.python.org/wheel_egg/>`__

- `PEP 427 -- The Wheel Binary Package Format 1.0
  <https://www.python.org/dev/peps/pep-0427/>`__

- `PEP 425 -- Compatibility Tags for Built Distributions
  <https://www.python.org/dev/peps/pep-0425/>`__

- `pip wheel documentation
  <https://pip.pypa.io/en/stable/reference/pip_wheel/>`__

- `Hosting your Own Simple Repository
  <https://packaging.python.org/self_hosted_repository/>`__

- `piwheels: building a faster Python package repository for Raspberry Pi users
  <http://bennuttall.com/piwheels-building-a-faster-python-package-repository-for-raspberry-pi-users/>`__