Interactive tree visualizations for your Home Assistant entity hierarchy.
Preview available at hypertree.eightypercent.dev.
HA Hypertree connects to a Home Assistant instance and renders its areas, devices, and entities as an interactive force-directed graph. Entity states update in real time over WebSocket.
Features include domain/area/state filtering, search with optional filter mode, automation edge visualization, and constellation rendering with customizable star effects.
Install as a custom panel directly in Home Assistant via HACS:
- In HACS, go to the three-dot menu and select Custom repositories.
- Add
https://github.com/knowald/ha-hypertree-hacswith category Integration. - Install "HA Hypertree" from the HACS store.
- Restart Home Assistant.
- Go to Settings > Devices & Services > Add Integration and search for "HA Hypertree".
A new "Hypertree" entry appears in the sidebar. No token or login needed, the panel uses your existing HA session.
You can also run it as a standalone webapp. You need a Long-Lived Access Token from your Home Assistant instance.
- In Home Assistant, go to your profile page and create a Long-Lived Access Token.
- Run the app (see below) and enter your HA URL and token in the login form.
Credentials are saved in your browser's local storage for auto-reconnect.
npm install
npm run devThen open the URL shown by Vite (usually http://localhost:5173).
npm run build
npm run previewThe built files in dist/ can be served by any static file server.
To test the protocol mismatch warning or connect to an HTTPS HA instance from localhost, generate a local certificate with mkcert and start the dev server over HTTPS:
just dev-httpsThe dev server detects .certs/ automatically and serves over HTTPS when the certificates are present.
- Click a node to copy its ID to the clipboard
- Shift+click an area or device node to collapse/expand its children
- Right-click a node for a context menu (Copy ID, View History, View Logbook, Open in HA, Collapse/Expand)
Collapsed nodes show a dashed ring and a badge with the hidden entity count.
`(backtick) - Toggle debug console
This app is entirely client-side. Your browser connects directly to your Home Assistant instance via WebSocket. There is no backend, no analytics, and no telemetry.
MIT
