esphome-device-builder-frontend

What it is and what it does

This package ships a prebuilt web frontend for the ESPHome Device Builder Dashboard, a tool for managing IoT devices running ESPHome firmware. The frontend is built with Lit web components and TypeScript, bundled with Rspack, and includes a YAML editor, device discovery and adoption flows, and board selection wizard. It is distributed as a Python wheel and is meant to be bundled with and run as part of the backend ESPHome Device Builder service—not deployed independently. The package contains only the compiled assets and the minimal Python glue to expose them; actual deployment and backend logic live in the separate device-builder repository.

End users installing this package directly will get the prebuilt frontend assets, but the dashboard itself only runs when the backend is also deployed. Developers working on the frontend source will clone the backend repository and follow its setup instructions. The package supports Python 3.12, 3.13, and 3.14, has no runtime dependencies, and is actively maintained with frequent releases.

Use it for:

• Deploy the ESPHome Device Builder Dashboard as part of a backend service to manage and configure IoT devices
• Bundle the prebuilt frontend with a custom ESPHome deployment or self-hosted instance
• Contribute frontend improvements by cloning the source repository and running the dev server locally

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides a prebuilt web frontend for the ESPHome Device Builder Dashboard, a dashboard for managing, configuring, and deploying ESPHome IoT device firmware.

Yes, if you are deploying the ESPHome Device Builder backend and need the web frontend. The package has low install friction, no dependencies, and is actively maintained. However, this is a frontend-only distribution—it is not useful on its own and requires the backend service to be running. Verify that you need the full dashboard before installing; for standalone ESP device flashing and provisioning, ESPHome Web (a separate build target) may be more appropriate.

Install

esphome-device-builder-frontend on PyPI

pip install esphome-device-builder-frontend

uv add esphome-device-builder-frontend

poetry add esphome-device-builder-frontend

Installing esphome-device-builder-frontend

Before you install

Low install friction with no runtime dependencies. Actively maintained with a release 1 day old and recent commits. Marked as Alpha status, so expect ongoing development and potential API changes.

License in practice

Licensed under Apache-2.0 (permissive), allowing commercial and private use with minimal restrictions beyond attribution and liability disclaimers.

Quickstart

# Install the frontend package
pip install esphome-device-builder-frontend

# The frontend is prebuilt and bundled; it runs as part of the backend.
# See https://github.com/esphome/device-builder for backend setup and deployment.

The ESPHome Device Builder backend must be running on localhost:6052 (or configured elsewhere) for the frontend to function; this package alone does not provide a working dashboard.

Verify before relying

• Whether this package can be used standalone or requires the backend ESPHome Device Builder to be running
• Whether the prebuilt frontend assets are sufficient for end-user deployment or if source compilation is needed
• Performance characteristics and browser compatibility requirements for the Lit-based web components

Package facts

Evidence: esphome_device_builder_frontend-0.1.302-py3-none-any.whl

Tags

More Home Automation packages