{"id":21436,"library":"home-assistant-frontend","title":"Home Assistant Frontend","description":"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).","status":"active","version":"20260325.8","language":"python","source_language":"en","source_url":"https://github.com/home-assistant/frontend","tags":["home-assistant","frontend","web-ui"],"install":[{"cmd":"pip install home-assistant-frontend","lang":"bash","label":"Install latest"}],"dependencies":[],"imports":[{"note":"Package name uses underscores, not hyphens.","wrong":"from hass_frontend import HassFrontend","symbol":"HassFrontend","correct":"from home_assistant_frontend import HassFrontend"}],"quickstart":{"code":"import os\nfrom home_assistant_frontend import HassFrontend\n\nurl = os.environ.get('HASS_URL', 'http://localhost:8123')\ntoken = os.environ.get('HASS_TOKEN', '')\n# HassFrontend is an ASGI/static handler typically used by Home Assistant core.\n# Direct usage outside of Home Assistant is rare.\nprint('Imports successful')","lang":"python","description":"Basic import and environment setup."},"warnings":[{"fix":"Pin exact version (e.g., 'home-assistant-frontend==20260325.8') in requirements.","message":"Versioning is date-based (YYYYMMDD.N). Do not pin to minor versions; always use exact version.","severity":"breaking","affected_versions":"all"},{"fix":"Use the latest package; import from `home_assistant_frontend` instead of `frontend`.","message":"Older versions exposed a werkzeug-based WSGI app. Newer versions use an ASGI/static-only approach.","severity":"deprecated","affected_versions":"< 20211000.0"},{"fix":"Upgrade to Python 3.14 or later.","message":"Requires Python >=3.14.0. Older Python versions will not install.","severity":"gotcha","affected_versions":">=20260325.0"},{"fix":"Do not import directly; let Home Assistant core manage it.","message":"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.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Install with `pip install home-assistant-frontend` and import as `from home_assistant_frontend import ...`.","cause":"Using hyphens in import path or not installing the package.","error":"ModuleNotFoundError: No module named 'home_assistant_frontend'"},{"fix":"Verify correct export by inspecting the package's __init__.py or use `home_assistant_frontend` as a static file server.","cause":"Trying to access internal symbols that may not be exported.","error":"ImportError: cannot import name 'HassFrontend' from 'home_assistant_frontend'"},{"fix":"Ensure both are from the same release: `pip install home-assistant-frontend==<core_release_date>`.","cause":"Frontend version does not match the core Home Assistant server version.","error":"Exception: Version mismatch between frontend and core"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}