# studioimaginaire/phue

A Python library for the Philips Hue system

Repository: https://github.com/studioimaginaire/phue
Canonical: https://ross.abutalabs.com/products/phue
Language: Python
License: NOASSERTION
License Family: other
Last push: 2024-10-02T14:53:48+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 5041, "days_push": 700, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1567, forks 266 (observed 2026-08-28T04:05:05.000977+00:00)

## What it is
phue is a full-featured, dependency-free Python library for controlling the Philips Hue lighting system via the Hue Bridge API 1.0. It supports lights, groups, schedules, scenes, and sensors, and can be used procedurally or through object-oriented Light and Group objects.

## Use cases
- control philips hue lights from python
- turn hue bulbs on and off programmatically
- set brightness and color of smart lights with a script
- register a python app with a hue bridge
- automate smart home lighting schedules and scenes
- read hue sensor data in python

## When to choose
- you want a simple, single-file, zero-dependency Python client for the Hue API
- you need to control lights, groups, scenes, schedules, or sensors on Hue API 1.0
- you prefer both procedural and object-oriented interfaces for light control

## When to avoid
- you need Philips Hue API v2 with Bluetooth or the new event-based streaming API
- you are controlling non-Hue smart lighting brands
- you need a language other than Python

## Facets
- artifact type: library
- maturity: active
- function: sdk
- domain: iot, developer-tools
- platform: python, cross-platform
- tags: philips-hue, smart-lighting, smart-home, bridge-api, zero-dependency, automation

## Member repositories
- studioimaginaire/phue (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:05.000977+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-30T03:59:01.622565+00:00, confidence not recorded.
  - readme: https://github.com/studioimaginaire/phue (fetched 2026-08-28T04:05:05.000977+00:00, sha 13d6669a48e5)
  - registry_pypi: https://pypi.org/pypi/phue/json (fetched 2026-08-29T11:28:59.513849+00:00, sha fa4a57614478)
- Data as of 2026-08-30T08:39:29.467469+00:00.