---
id: adafruit-blinka
version: "9.2.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# Adafruit-Blinka — CircuitPython APIs for non-CircuitPython versions of Python such as CPython on Linux and MicroPython.

License: permissive · Maintenance: active · Downloads: 172.4K/mo

## What it is and what it does

Adafruit-Blinka is a compatibility layer that brings CircuitPython's hardware abstraction APIs to CPython and MicroPython environments. It emulates modules for digital I/O, I2C, SPI, UART, analog input/output, PWM, NeoPixels, keypad scanning, and USB HID, allowing you to write code in CircuitPython style that runs on Linux single-board computers. The package handles platform detection and pin mapping automatically, translating high-level calls into appropriate low-level hardware operations for your host.

The library is designed for developers who want to prototype or deploy applications on platforms running full Python interpreters rather than CircuitPython's minimal runtime. It includes both hardware-driven interfaces using native kernel drivers and software-driven fallbacks for I2C and SPI, making it adaptable to various hardware configurations. Test suites are designed to run on either CircuitPython or CPython plus this compatibility layer to verify API conformance.

Use it for:

- Prototype and test CircuitPython applications on Linux single-board computers before deploying to CircuitPython boards.
- Control GPIO, I2C, SPI, and UART peripherals from Python on embedded Linux using CircuitPython-compatible syntax.
- Write cross-platform hardware tests that run on both CircuitPython devices and CPython/MicroPython hosts.
- Build applications needing the full Python standard library while controlling low-level hardware interfaces.
- Emulate NeoPixel, keypad, and PWM functionality on non-CircuitPython platforms for LED and motor control.

## Worth the install?

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

Adafruit-Blinka emulates CircuitPython APIs on CPython and MicroPython hosts, enabling CircuitPython-style code to run on Linux single-board computers and other non-CircuitPython platforms.

Yes, if you are developing on CPython or MicroPython and need CircuitPython-compatible hardware APIs. The package is actively maintained, has no known vulnerabilities, installs with low friction, and is permissively licensed. Do not install on devices already running CircuitPython, where built-in modules should be used instead.

## Install

pip install adafruit-blinka
uv add adafruit-blinka
poetry add adafruit-blinka

## Installing Adafruit-Blinka

Before you install: Low install friction with a pure-Python wheel. Active maintenance (last commit 2026-07-30, release 15 days ago). Seven runtime dependencies including Adafruit-PlatformDetect, Adafruit-PureIO, pyftdi, and binho-host-adapter for hardware-specific support.

License in practice: MIT license (permissive) places no restrictions on use, modification, or distribution in proprietary or open-source projects.

Quickstart:

pip3 install Adafruit-Blinka

import time
from Adafruit_Blinka import board
from Adafruit_Blinka import digitalio

led = digitalio.DigitalInOut(board.D18)
led.direction = digitalio.Direction.OUTPUT
led.value = True
time.sleep(0.5)

Requires Python 3.9 or later; intended for CPython on GNU/Linux or MicroPython—not for devices already running CircuitPython, where built-in modules should be used instead.

Verify before relying:

- Which specific board types and microcontroller families are fully supported beyond Raspberry Pi.
- Performance characteristics when using software-driven interfaces (bitbangio) vs. hardware-driven (busio).
- Compatibility matrix with specific versions of MicroPython implementations.
- Whether all emulated modules (analogio, keypad, neopixel_write, usb_hid) are production-ready or experimental.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 172.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

circuitpython api emulation, circuitpython on raspberry pi, gpio abstraction layer, hardware interface compatibility, circuitpython cpython bridge, embedded python hardware control, cross-platform microcontroller api, hardware-abstraction, embedded-python, gpio-control

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