Registry / web-framework / esphome-dashboard

esphome-dashboard

library20260425.0pypypi✓ verified 85d ago

ESPHome Dashboard is the web-based UI for managing ESPHome devices. It provides device discovery, configuration editing, firmware building, and OTA updates. The current version as of April 2026 is 20260425.0, with frequent releases tied to ESPHome updates (weekly to monthly).

web-framework devops http-networking

pip install esphome-dashboard

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · ESPHOME-DASHBOARD

esphome-dashboard

web-frameworkpythonv20260425.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

entrypoint

✓ from esphome_dashboard import entrypoint

✗ from esphome_dashboard import start_web_server

Starts the ESPHome dashboard web server. Requires configuration directory path; optionally set password via DASHBOARD_PASSWORD env var.

import os from esphome_dashboard import start_web_server # Start the dashboard (configuration via environment variables) start_web_server( configuration_path=os.environ.get('CONFIG_PATH', '/config'), password=os.environ.get('DASHBOARD_PASSWORD', '') )

Debug

Known issues

gotchaThe dashboard requires a running ESPHome instance (esphome dashboard command) and does not operate standalone as a Python library.

fix

Use the esphome CLI (esphome dashboard) to launch the dashboard instead of importing esphome_dashboard directly.

affects: all

gotchaThe package esphome-dashboard on PyPI is a Python wrapper that launches a bundled Node.js server, not a pure Python library.

fix

Do not expect to import Python classes; the package primarily launches a subprocess.

affects: all

deprecatedThe dashboard configuration via YAML file (dashboard_import) is deprecated in favor of environment variables and command-line flags.

fix

Use command-line arguments (e.g., --port, --password) or env vars (DASHBOARD_PASSWORD, ESPHOME_DASHBOARD_USE_IMPROV) instead.

affects: >=2025.1

gotchaThe dashboard's bundled Node.js server may conflict with system Node.js or require additional system dependencies (e.g., libnss3).

fix

Install dependencies: sudo apt install libnss3 libnspr4 libatk1.0-0 libatk-bridge2.0-0 libcups2 libdrm2 libdbus-1-3 libxkbcommon0 libxcomposite1 libxdamage1 libxrandr2 libgbm1 libpango-1.0-0 libcairo2 libasound2

affects: all

Upgrade

Version history

20260425.0latest on PyPI · released Apr 25, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

17 hits · last 30 days

node

Bingbot

OpenAI (training)

Resources

githubhttps://github.com/esphome/dashboard ↗

packagehttps://pypi.org/project/esphome-dashboard/ ↗

homepagehttps://esphome.io ↗