# peter-murray/node-hue-api

Node.js Library for interacting with the Philips Hue Bridge and Lights

Repository: https://github.com/peter-murray/node-hue-api
Canonical: https://ross.abutalabs.com/products/node-hue-api
Language: TypeScript
License: Apache-2.0
License Family: permissive
Topics: hue-bridge, hue-api, hue-lights, javascript, nodejs, scene, schedule, hue, lights, smarthome, smart-home
Last push: 2026-07-12T16:10:54+00:00

## Health v2 (maintenance only)
Score: 64/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 92, release rhythm 8, longevity 100
- inputs: {"age_days": 4989, "days_push": 52, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1196, forks 139 (observed 2026-08-28T04:03:56.998665+00:00)

## What it is
A Node.js library that abstracts the Philips Hue Bridge REST API for controlling lights, sensors, scenes, schedules, groups, and rules. It supports both local network and remote internet access with full coverage of the documented Hue API.

## Use cases
- control philips hue lights from node.js
- discover hue bridges on the local network
- create and manage hue scenes and schedules
- toggle smart lights programmatically
- integrate hue lighting into home automation scripts
- read sensor data from hue bridge
- control hue lights over the internet via remote api

## When to choose
- you need a mature, full-coverage Node.js client for the Philips Hue Bridge API
- you want both local and remote Hue API access from JavaScript
- you need to manage lights, scenes, schedules, sensors, and rules programmatically

## When to avoid
- you need support for the newest Hue Bridge v2/CLIP APIs, as the project is no longer actively maintained
- you are not using Node.js or JavaScript
- you need a maintained library with ongoing bug fixes and new feature support

## Facets
- artifact type: library
- maturity: maintenance
- function: sdk, http-client
- domain: iot
- platform: -
- tags: philips-hue, hue-bridge, smart-lighting, home-automation, rest-api-client, automation, nodejs, javascript

## Member repositories
- peter-murray/node-hue-api (main) score 64

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:56.998665+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:22:03.689284+00:00, confidence not recorded.
  - readme: https://github.com/peter-murray/node-hue-api (fetched 2026-08-28T04:03:56.998665+00:00, sha f4332e55b4d2)
- Data as of 2026-08-30T08:39:29.467469+00:00.