---
id: rpi-gpio
version: "0.7.1"
license: MIT
license_treatment: permissive
maintenance: abandoned
---

# RPi.GPIO — A module to control Raspberry Pi GPIO channels

License: permissive · Maintenance: abandoned · Downloads: 97.6K/mo

## What it is and what it does

RPi.GPIO is a Python module for controlling GPIO pins on Raspberry Pi hardware. It allows you to set pins as inputs or outputs, read digital states, detect rising/falling edges with callbacks, and generate software PWM signals. The module provides both BCM (Broadcom GPIO numbering) and BOARD (physical pin numbering) modes, plus pull-up/pull-down resistor configuration on input pins.

The package is a C extension that accesses GPIO hardware via /dev/gpiomem (or /dev/mem as fallback), avoiding the need for root privileges in most cases. However, the author explicitly warns that it is unsuitable for real-time or timing-critical applications because Python's garbage collection and Linux kernel multitasking introduce unpredictable jitter. The package does not support SPI, I2C, hardware PWM, or serial functionality—only digital I/O and software PWM are available.

Use it for:

- Control LEDs, relays, and other digital outputs on a Raspberry Pi project
- Detect button presses and other digital input events with edge-triggered callbacks
- Generate PWM signals for motor speed control or LED brightness using software PWM
- Implement home automation or IoT projects requiring GPIO-based sensor/actuator control
- Read sensor states and respond to state changes in hobbyist robotics applications

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

RPi.GPIO provides Python control over Raspberry Pi GPIO pins, supporting digital input/output, edge detection, and software PWM on all channels.

No, not for new projects. The package is abandoned (no updates for 1650 days) and explicitly unsuitable for timing-critical work. Install only if you are maintaining legacy code already using RPi.GPIO. For new Raspberry Pi GPIO projects, consider actively maintained alternatives.

## Install

pip install rpi-gpio
uv add rpi-gpio
poetry add rpi-gpio

## Installing RPi.GPIO

Before you install: Medium install friction due to platform-specific wheels (linux_armv6l only) and C extension compilation requirements. Package is abandoned as of 1650 days since last release, with no active maintenance or repository updates.

License in practice: MIT license permits commercial and private use with minimal restrictions, requiring only license and copyright notice retention.

Quickstart:

import RPi.GPIO as GPIO
GPIO.setmode(GPIO.BCM)
GPIO.setup(GPIO.OUT)
GPIO.output(GPIO.HIGH)
GPIO.cleanup()

Requires running on Raspberry Pi hardware with Linux kernel; not suitable for real-time or timing-critical applications due to Python garbage collection and kernel multitasking jitter.

Verify before relying:

- Whether the package works reliably on current Raspberry Pi models (last tested with Python 3.10, released 2022-02-06)
- Compatibility with modern Raspberry Pi OS distributions and kernel versions
- Whether SPI, I2C, hardware PWM, serial, or one-wire functionality mentioned as 'planned' was ever implemented

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: medium
- Maintenance: abandoned
- Downloads: 97.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

raspberry pi gpio control python, rpi pin control library, raspberry pi digital io, gpio edge detection events, software pwm raspberry pi, rpi board pin setup, raspberry pi hardware interface, raspberry-pi, gpio-control, abandoned

[View on SkillFed](https://skillfed.io/packages/rpi-gpio) · [View on PyPI](https://pypi.org/project/rpi-gpio/)