Skip to main content
Archived

This project has been archived by its maintainers, and is no longer receiving any updates.

CI PyPI version

PEP 484 stubs for Home Assistant Core

This is unofficial stub-only package generated from Home Assistant Core sources. You can use it to enable type checks against Home Assistant code in your custom component or AppDaemon app.

How to use

Add it to dev dependencies of your project. I recommend to use uv for managing dependencies:

uv add --dev homeassistant-stubs

Please note that only stubs from strictly typed modules are added in this package. This includes all core modules and some components. Generic components like sensor, light or media_player are already typed.

If your project imports not yet typed components, mypy will be unable to find that module. The best thing you can do to fix this is to submit PR to HA Core which adds type hints for these components. After that stubs for these components will become available in this package.

Motivation

Home Assistant maintainers don't want to distribute typing information with homeassistant package ([1], [2]). The reason is that PEP 561 says that py.typed marker is applied recursively and the whole package must support type checking. But many of the Home Assistant components are currently not type checked.

How it works

  • update_stubs.py script extracts list of strictly typed modules from Home Assistant configs.
  • Then it runs stubgen which is shipped with mypy to generate typing stubs.
  • New versions are generated and published automatically every 12 hours.

Metadata

Release files for homeassistant-stubs 2025.8.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for homeassistant-stubs 2025.8.3
File Size Uploaded Provenance Actions
homeassistant_stubs-2025.8.3.tar.gz 1.2 MB Without provenance Details for homeassistant_stubs-2025.8.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for homeassistant-stubs 2025.8.3
File Interpreter ABI Platform Actions
homeassistant_stubs-2025.8.3-py3-none-any.whl Python 3 none any Details for homeassistant_stubs-2025.8.3-py3-none-any.whl

Total release size: 4.4 MB

Release files / homeassistant_stubs-2025.8.3.tar.gz

Download URL homeassistant_stubs-2025.8.3.tar.gz
Size 1.2 MB
Tags Source
SHA-256 checksum
How to use checksums
f5dc6bebc356482c4fd2339655fddbd415fa7132e23e39e1fe893f1753f702c3
BLAKE2b-256 checksum
How to use checksums
a4b9c4e3828777b84ec2bb130a7b0497488498d449d6fd92e7d495f33af82c78
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.8.13

Release files / homeassistant_stubs-2025.8.3-py3-none-any.whl

Download URL homeassistant_stubs-2025.8.3-py3-none-any.whl
Size 3.2 MB
Tags Python 3
SHA-256 checksum
How to use checksums
ef3579ebf3167f3e3f23c886d7af9489164e06e4562e9f5919a4f958a2ddf636
BLAKE2b-256 checksum
How to use checksums
9463dd97d4ac10b3c302db2de1e06c43794e2704e8022a6ecd86ffee30647b5c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.8.13

Security for homeassistant-stubs 2025.8.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page