---
id: pyhaversion
version: "24.6.1"
license: MIT
license_treatment: permissive
maintenance: active
---

# pyhaversion — Get the latest Home Assistant version from various sources.

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

## What it is and what it does

pyhaversion is a Python library that retrieves the latest Home Assistant version information from various sources. It uses aiohttp for async HTTP requests and awesomeversion for version handling, making it suitable for applications that need to check for Home Assistant updates without blocking.

The package is designed for developers integrating Home Assistant version-checking into tools, dashboards, or automation workflows. It abstracts away the complexity of querying multiple version sources, presenting a unified interface for fetching current release information.

Use it for:

- Check for Home Assistant updates in a monitoring dashboard or management tool
- Automate Home Assistant deployment pipelines by querying the latest available version
- Build a bot or notification system that alerts users when new Home Assistant releases are available
- Integrate version checking into Home Assistant companion applications or add-ons

## Worth the install?

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

Fetches the latest Home Assistant version information from multiple sources via async HTTP requests.

Yes, if you need to programmatically fetch Home Assistant version information. The package has low install friction, permissive licensing, no known vulnerabilities, and active maintenance. The 794-day gap since the last release is notable but the repository shows recent commits, suggesting the maintainer is still engaged. Verify that the supported version sources match your needs before committing.

## Install

pip install pyhaversion
uv add pyhaversion
poetry add pyhaversion

## Installing pyhaversion

Before you install: Low friction install with only two runtime dependencies (aiohttp and awesomeversion). Actively maintained as of 2026-08-09 with recent commits, though 794 days have passed since the last release.

License in practice: MIT license permits unrestricted use, modification, and distribution with minimal legal constraints.

Quickstart:

pip install pyhaversion

import aiohttp
from pyhaversion import LatestVersionFetcher

# Requires async context; see example.py in repository for full usage

Requires Python 3.12 or later (minimum version enforced by requires_python constraint)

Verify before relying:

- Which specific Home Assistant version sources are supported (e.g., GitHub releases, official API, etc.)
- Whether the package handles version comparison or only retrieval
- Rate limiting or caching behavior when querying multiple sources

## Package facts

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

## Tags

home assistant version checker, get latest homeassistant release, homeassistant version lookup, async version fetcher, home assistant update checker, homeassistant, version-management

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