Repolode
Submit
diyhue

diyhue/diyHue

A Python emulator of the Philips Hue Bridge that lets Hue-compatible apps and smart home systems control many non-Hue lights and devices locally.

Open-source alternative to:Philips Hue Bridge

View on GitHubWebsite
Stars
1,832
Forks
298
Open issues
106
Last commit
14 days ago

What is it?

diyHue emulates a Philips Hue Bridge so that apps and smart home systems expecting a Hue Bridge can control lights from other sources. It can drive ZigBee lights through a Raspbee, Deconz or IKEA Trådfri gateway, MiLight bulbs, WS2812B and SK6812 LED strips, and ESP8266-based bulbs and switches running custom firmware.

The software is written in Python and is designed to run continuously on small hardware such as a Raspberry Pi, or in Docker. It works with a range of clients, including Hue Essentials, Home Assistant, Openhab, Domoticz and Amazon Alexa for light control. Everything runs on the local network, with no cloud connection required.

The project supports Hue groups, scenes, and entertainment mode, and it can be set up to start automatically. Documentation is hosted on readthedocs.

Key features

  • 01Emulates a Philips Hue Bridge for Hue-compatible apps and smart home systems.
  • 02Controls ZigBee, MiLight, WS2812B/SK6812 LED strips and ESP8266-based lights.
  • 03Supports groups, scenes, and Hue entertainment functions.
  • 04Runs locally without a cloud connection.
  • 05Runs on small devices like the Raspberry Pi or in Docker.

Use cases

  • Controlling non-Hue LED strips or bulbs from the official Hue app or Hue Essentials.
  • Running a local, cloud-free lighting hub on a Raspberry Pi for Home Assistant.
  • Bridging ZigBee or MiLight lights into Alexa or other Hue-compatible systems.

Quick start

  1. 1

    Install the Python modules listed in requirements.txt

    pip install -r requirements.txt
  2. 2

    Or run diyHue with Docker using the published image

    docker pull diyhue/core
  3. 3

    Read the full setup instructions in the documentation

Things to know

  • Meant to run 24/7 on a small always-on device such as a Raspberry Pi.
  • Requires extra system packages such as coap-client and faketime, or Docker.
  • Some features, such as remote API access, are not supported.
  • Licensing is listed as NOASSERTION, so check the LICENSE file before reuse.

Topics

#smart-home#home-automation#philips-hue#iot#raspberry-pi#esp8266#home-assistant

FAQ

What is diyHue?
A Python emulator of the Philips Hue Bridge that lets Hue-compatible apps and smart home systems control many non-Hue lights and devices locally. diyHue emulates a Philips Hue Bridge so that apps and smart home systems expecting a Hue Bridge can control lights from other sources. It can drive ZigBee lights through a Raspbee, Deconz or IKEA Trådfri gateway, MiLight bulbs, WS2812B and SK6812 LED strips, and ESP8266-based bulbs and switches running custom firmware.
Is diyHue free to use? What license does it have?
diyHue is open source under the Other license. Check the license terms before using it in commercial products.
Is diyHue still maintained?
Actively maintained. The last commit to diyHue was on Oct 23, 2026.
What can I use diyHue for?
Controlling non-Hue LED strips or bulbs from the official Hue app or Hue Essentials. Running a local, cloud-free lighting hub on a Raspberry Pi for Home Assistant. Bridging ZigBee or MiLight lights into Alexa or other Hue-compatible systems.
How do I install diyHue?
Install the Python modules listed in requirements.txt: pip install -r requirements.txt Or run diyHue with Docker using the published image: docker pull diyhue/core Read the full setup instructions in the documentation
Where can I get diyHue?
The source code and installation instructions are on GitHub: https://github.com/diyhue/diyHue

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects