whatisgithub

What is python-periphery?

peng-zhihui/python-periphery — explained in plain English

Analysis updated 2026-07-18 · repo last pushed 2019-11-09

★ 100Audience · developerComplexity · 2/5DormantLicenseSetup · easy

In one sentence

A pure-Python library for controlling hardware on Linux boards like Raspberry Pi, GPIO, PWM, SPI, I2C, serial, and more, without writing low-level code.

Mindmap

mindmap
  root((repo))
    What it does
      Reads and writes GPIO
      Controls PWM and LEDs
      Talks SPI and I2C
      Supports serial and MMIO
    Tech stack
      Python 2 and 3
      Pure Python
      Linux kernel interfaces
    Use cases
      Home automation sensors
      Robotics motor control
      Embedded prototyping
    Audience
      Embedded developers
      Makers and hobbyists

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Read a temperature sensor and control a fan motor from a Raspberry Pi or BeagleBone using plain Python

USE CASE 2

Flash an LED or dim it with PWM without writing kernel drivers

USE CASE 3

Talk to sensors and chips over SPI or I2C for an embedded project

USE CASE 4

Control GPIO pins directly for a home automation or robotics prototype

What is it built with?

Python

How does it compare?

peng-zhihui/python-peripherya458378326454/windows-optimizeraimino-tech/opendocswork-mcp
Stars100100100
Language——Rust
Last pushed2019-11-09——
MaintenanceDormant——
Setup difficultyeasyeasymoderate
Complexity2/51/53/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

Pure Python with no compilation needed, but you do need a Linux board with the relevant hardware interfaces enabled.

MIT licensed, free to use in personal or commercial projects.

Copy-paste prompts

Prompt 1
Show me how to use python-periphery to read a GPIO pin and turn on an LED on my Raspberry Pi.
Prompt 2
Explain how to control motor speed with PWM using this library.
Prompt 3
Help me set up an I2C connection to a sensor using python-periphery.
Prompt 4
Walk me through reading serial data from a USB device with this library.

Frequently asked questions

What is python-periphery?

A pure-Python library for controlling hardware on Linux boards like Raspberry Pi, GPIO, PWM, SPI, I2C, serial, and more, without writing low-level code.

Is python-periphery actively maintained?

Dormant — no commits in 2+ years (last push 2019-11-09).

What license does python-periphery use?

MIT licensed, free to use in personal or commercial projects.

How hard is python-periphery to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is python-periphery for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.

What are similar repos?