gpiozero

Python library for Raspberry Pi GPIO devices (LEDs, buttons, sensors), installed by default in Raspberry Pi OS.

library also known as GPIO Zero

Knowledge about gpiozero

GPIO on Raspberry Pi 5: RPi.GPIO-based code stops working, use gpiozero with lgpiowarning · unverified · On Raspberry Pi 5 only the lgpio pin factory works in gpiozero; the RPi.GPIO, pigpio and native factories do not support Pi 5. Write GPIO code with gpiozero and keep within the 3.3 V and current limits.
RPi.GPIO edge detection broke with kernel 6.6 (not only on Pi 5): switch to rpi-lgpio or gpiozerowarning · unverified · Since Raspberry Pi's 6.6 kernel, global GPIO numbers start at 512 instead of 0, and RPi.GPIO calls such as add_event_detect fail even on a Pi 4. Raspberry Pi engineers point to rpi-lgpio (same API, apt package python3-rpi-lgpio) or gpiozero. On Pi 5 the header GPIOs moved from gpiochip4 to gpiochip0.
Raspberry Pi pin numbering: GPIO (BCM) numbers vs physical header pinsguide · unverified · 'Pin 17' means different things: BCM/GPIO numbering names the SoC signal, BOARD numbering counts header positions. gpiozero always works in BCM numbering and accepts 'BOARD11' or 'J8:11' as translations. Mixing the two is a classic wiring bug.
pip install fails with 'externally-managed-environment' on Raspberry Pi OS Bookwormwarning · unverified · Since Bookworm, pip can only install into a virtual environment (PEP 668). Use apt for system packages or a venv for your project; --system-site-packages keeps apt-installed libraries like gpiozero available.