Home Assistant Frontend

20260325.8 verified Mon Apr 27 auth: no python

The frontend for Home Assistant, built with Lit and Web Awesome components. This package delivers the web UI served by Home Assistant. Current version: 20260325.8. Released daily (versioned by date).

pip install home-assistant-frontend

Common errors

error ModuleNotFoundError: No module named 'home_assistant_frontend' ↓

cause Using hyphens in import path or not installing the package.

fix

Install with pip install home-assistant-frontend and import as from home_assistant_frontend import ....

error ImportError: cannot import name 'HassFrontend' from 'home_assistant_frontend' ↓

cause Trying to access internal symbols that may not be exported.

fix

Verify correct export by inspecting the package's __init__.py or use home_assistant_frontend as a static file server.

error Exception: Version mismatch between frontend and core ↓

cause Frontend version does not match the core Home Assistant server version.

fix

Ensure both are from the same release: pip install home-assistant-frontend==<core_release_date>.

Warnings

breaking Versioning is date-based (YYYYMMDD.N). Do not pin to minor versions; always use exact version. ↓

fix Pin exact version (e.g., 'home-assistant-frontend==20260325.8') in requirements.

deprecated Older versions exposed a werkzeug-based WSGI app. Newer versions use an ASGI/static-only approach. ↓

fix Use the latest package; import from `home_assistant_frontend` instead of `frontend`.

gotcha Requires Python >=3.14.0. Older Python versions will not install. ↓

fix Upgrade to Python 3.14 or later.

gotcha This package is not intended for direct use. It is a dependency of Home Assistant core. Manual imports may fail if core Python modules (like `homeassistant`) are not installed. ↓

fix Do not import directly; let Home Assistant core manage it.

Imports

HassFrontend

wrong

from hass_frontend import HassFrontend

correct

from home_assistant_frontend import HassFrontend

Package name uses underscores, not hyphens.

Quickstart

Basic import and environment setup.

import os
from home_assistant_frontend import HassFrontend

url = os.environ.get('HASS_URL', 'http://localhost:8123')
token = os.environ.get('HASS_TOKEN', '')
# HassFrontend is an ASGI/static handler typically used by Home Assistant core.
# Direct usage outside of Home Assistant is rare.
print('Imports successful')