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 v0.9.0 beta 4 released on 25th October 2015.


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

from gpiozero import LED, Button

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-w1thermsensor python3-w1thermsensor 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 0.9.0
Filename, size File type Python version Upload date Hashes
Filename, size gpiozero-0.9.0-py2.py3-none-any.whl (19.8 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size gpiozero-0.9.0.tar.gz (15.8 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