Skip to main content

A simple interface to everyday GPIO components used with Raspberry Pi

Project description

A simple interface to everyday GPIO components used with Raspberry Pi.

Created by Ben Nuttall of the Raspberry Pi Foundation, Dave Jones, and other contributors.

Latest release

The latest release is 1.0 released on 16th November 2015.


Component interfaces are provided to allow a frictionless way to get started with physical computing:

from gpiozero import LED
from time import sleep

led = LED(2)

while True:

With very little code, you can quickly get going connecting your components together:

from gpiozero import LED, Button
from signal import pause

led = LED(2)
button = Button(3)

button.when_pressed = led.on
button.when_released =


The library includes interfaces to many simple everyday components, as well as some more complex things like sensors, analogue-to-digital converters, full colour LEDs, robotics kits and more.


First, install the dependencies:

sudo apt-get install python-pip python3-pip python-spidev python3-spidev

Install with pip:

sudo pip install gpiozero
sudo pip-3.2 install gpiozero

Both Python 3 and Python 2 are supported. Python 3 is recommended!


Comprehensive documentation is available at


This project is being developed on GitHub. Join in:

  • Provide suggestions, report bugs and ask questions as Issues
  • Provide examples we can use as recipes
  • Contribute to the code

Alternatively, email suggestions and feedback to or add to the Google Doc.


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for gpiozero, version 1.0.0
Filename, size File type Python version Upload date Hashes
Filename, size gpiozero-1.0.0.tar.gz (17.6 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page