---
id: adafruit-circuitpython-typing
version: "1.12.3"
license: MIT
license_treatment: permissive
maintenance: active
---

# adafruit-circuitpython-typing — Types needed for type annotation that are not in `typing`

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

## What it is and what it does

This package supplies type annotation definitions needed for CircuitPython development that do not exist in Python's standard typing module. It is designed to support developers writing type-annotated CircuitPython code on host machines, particularly when using tools like Adafruit-Blinka for testing and development. The package depends on Adafruit-Blinka, adafruit-circuitpython-busdevice, adafruit-circuitpython-requests, and typing_extensions to provide a complete typing environment.

The library is explicitly not required at runtime for CircuitPython code execution and does not need to be included in CircuitPython bundles deployed to microcontroller boards. It serves as a development-time dependency for developers using type checkers and IDEs to validate their CircuitPython projects before deployment.

Use it for:

- Type-checking CircuitPython projects on a development machine using mypy or similar tools
- Providing IDE autocomplete and type hints when writing CircuitPython code in an editor
- Validating type annotations in CircuitPython libraries before publishing to the ecosystem
- Supporting Adafruit hardware projects that use Blinka for cross-platform compatibility

## Worth the install?

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

Provides type annotation definitions for CircuitPython code that extend the standard typing module with additional types not available in the base library.

Yes, if you are developing CircuitPython code and want type-checking support on your development machine. Install it as a development dependency (not in your CircuitPython bundle). The package is actively maintained, has no known vulnerabilities, and carries a permissive MIT license. Low install friction and clear scope make it a straightforward addition to a CircuitPython development workflow.

## Install

pip install adafruit-circuitpython-typing
uv add adafruit-circuitpython-typing
poetry add adafruit-circuitpython-typing

## Installing adafruit-circuitpython-typing

Before you install: Low install friction with a pure-Python wheel distribution. Active maintenance with last commit on 2026-04-23 and a recent release on 2025-10-27, indicating ongoing support for the CircuitPython ecosystem.

License in practice: MIT license is permissive, allowing use in both open-source and proprietary projects with minimal restrictions.

Quickstart:

pip install adafruit-circuitpython-typing

import adafruit_circuitpython_typing
# Use type annotations from the module in your CircuitPython code

Requires Python 3.8 or later; intended primarily for type-checking CircuitPython projects rather than runtime use on microcontroller boards.

Verify before relying:

- What specific type definitions this package adds beyond the standard typing module
- Whether this is meant for development/type-checking only or also for runtime on CircuitPython boards

## Package facts

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

## Tags

circuitpython type annotations, typing definitions circuitpython, adafruit blinka typing, micropython type hints, embedded systems type stubs, circuitpython, type-hints, embedded-dev

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