ESPHome-LibreTiny

ESPHome-LibreTiny is the official LibreTiny fork of ESPHome that adds native support for the BK7231 and RTL8710B chipsets, letting you use Tuya-based hardware…

  • Home Automation
  • Tools & Utilities
ESPHome-LibreTiny is the official LibreTiny fork of ESPHome that adds native support for the BK7231 and RTL8710B chipsets, letting you use Tuya-based hardware with ESPHome. It provides ready-made container builds so you no longer need to compile the container yourself, making it a convenient choice for homelabbers integrating these chips into Home Assistant.

Platform availability

Available on 2 of 10 platforms

  • Unraid
  • TrueNAS
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

68/100 Good

Maintained
100last commit 7 days ago
Popular
8212,105 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data
Security check
201 serious finding, 2 minor, CI, tests, OpenSSF Scorecard 6.6/10

Based on 4 of 5 factors.

Availability: platform listings confirmed today, links checked 22 days ago

GitHub stars
12,105
Open issues
683
Last commit
2026-11-14
Latest release
2026.10.2
Activity
rising

Checked 7 days ago - source: GitHub (esphome/esphome)

Resources & Compatibility

Requirements not published yet.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Enter device address, port, and key Set the ESPHome device's IP or .local name, the ESPHome API port (6053), and the encryption key (noise_psk) in the APIClient before connecting. If any of these are missing or wrong, the app can’t log in and you’ll get a connection error. source
  • Start the reconnect logic to connect After creating the connection client, create ReconnectLogic with the callbacks that run when the connection starts or drops, then call start(). Without start(), nothing tries to connect or automatically retries after the device disappears. source

Fetched 53 days ago - each note links to its source

Alternatives (4)

  • Blynk IoT - Blynk is a simple and powerful no-code application builder where you can prototype, deploy, and manage connected electronic devices at any…
  • RemoteXY - RemoteXY is easy way to make and use a mobile graphical user interface for controller boards.
  • Tasmota - Alternative firmware for ESP8266 with easy configuration using webUI, OTA updates, automation using timers or rules, expandability and enti…
  • esphome - ESPHome is the official container for creating custom firmware for ESP8266, ESP32, Raspberry Pi, and Beken boards.

Checked 40 days ago - source: AlternativeTo

Common questions

How do I migrate from the LibreTiny ESPHome add-on to the ESPHome add-on?

Move the config directory, check that the devices are present, and reboot Home Assistant.

Where do I find instructions for entering download mode on BK72xx or RTL8710BN/BX chips?

The LibreTiny docs include a flashing/dumping guide with download-mode instructions for Beken BK72xx and Realtek RTL8710BN/BX.

What connection details does an ESPHome API client need to connect to a device?

Use the device IP or .local name, the ESPHome API port 6053, and the noise_psk encryption key.

Why might the Home Assistant add-on list LibreTiny devices as new instead of online after an update?

In the 2023.9.0 thread, devices were listed as new instead of online until the add-on was updated to 2023.9.

Answers sourced from community.home-assistant.io, docs.libretiny.eu, github.com, www.reddit.com

Community

Collected 53 days ago - public community threads