aiohue
Python module to talk to Philips Hue.
Decision gist · record as of 2026-08-14
Yes. The package is actively maintained, has low install friction, carries no known security vulnerabilities, and uses a permissive license. It fills a clear niche for async-first Hue control in Python. Install it if you need to automate Philips Hue devices in an asyncio application or home automation system.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.11 or later; requires network access to a Philips Hue Bridge on the local network.
- Low install friction with a pure-Python wheel and minimal runtime dependencies.
- Actively maintained with a recent release and ongoing repository activity.
License · maintenance · safety
Apache-2.0 (permissive) — Licensed under Apache-2.0 (permissive), allowing commercial and private use with minimal restrictions beyond attribution and liability disclaimers.
last release 2026-07-30 (15 days) · last repo commit 2026-08-11 · 73 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 91,182 downloads/mo, #13,533 on PyPI
Alternatives
Verify before relying
pip install aiohue
import asyncio
from aiohue import Bridge
async def main():
bridge = Bridge(host="hue_bridge_ip")
await bridge.initialize()
# Access lights and control them
asyncio.run(main())- Whether the library handles authentication/pairing flow with the Hue Bridge automatically or requires manual setup.
- Performance characteristics when managing large numbers of lights or frequent state updates.
- Whether V2 API event subscriptions require persistent connection or support reconnection.
- Compatibility with third-party Hue-compatible devices beyond official Philips products.
What it is and what it does
Aiohue is an asynchronous Python library for communicating with Philips Hue Bridges to control lights and smart home devices. It wraps the Hue Bridge REST API in an async-first interface using aiohttp and asyncio, allowing non-blocking control of lights, scenes, and device groups. The library supports both the newer V2 API (which enables event-based updates without polling) and the legacy V1 API for backward compatibility with older bridges.
The library is designed for integration into larger async applications, particularly home automation systems. It requires Python 3.11 or later and depends on aiohttp for HTTP communication, asyncio-throttle for rate limiting, and awesomeversion for version comparison. The codebase mirrors the Philips Hue API structure, making it straightforward for developers familiar with the official API documentation to work with the library.
Use it for
- Automate home lighting scenes and schedules via asyncio-based applications.
- Build smart home integrations that react to Hue light state changes using V2 event subscriptions.
- Control individual lights or groups programmatically without polling overhead.
- Integrate Hue devices into larger home automation or IoT orchestration systems.
- Monitor and respond to light state changes in real-time applications.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
The package is actively maintained, has low install friction, carries no known security vulnerabilities, and uses a permissive license. It fills a clear niche for async-first Hue control in Python. Install it if you need to automate Philips Hue devices in an asyncio application or home automation system.
Install
aiohue on PyPI
Before you install
Low install friction with a pure-Python wheel and minimal runtime dependencies. Actively maintained with a recent release and ongoing repository activity.
Requires Python 3.11 or later; requires network access to a Philips Hue Bridge on the local network.
License in practice
Licensed under Apache-2.0 (permissive), allowing commercial and private use with minimal restrictions beyond attribution and liability disclaimers.
Quickstart
pip install aiohue
import asyncio
from aiohue import Bridge
async def main():
bridge = Bridge(host="hue_bridge_ip")
await bridge.initialize()
# Access lights and control them
asyncio.run(main())Verify before relying
- Whether the library handles authentication/pairing flow with the Hue Bridge automatically or requires manual setup.
- Performance characteristics when managing large numbers of lights or frequent state updates.
- Whether V2 API event subscriptions require persistent connection or support reconnection.
- Compatibility with third-party Hue-compatible devices beyond official Philips products.
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release >=3.11 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 3 packagesaiohttpasyncio-throttleawesomeversion |
| Maintenance | Actively maintained 15 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 91,182 / month, #13,533 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Environment :: ConsoleProgramming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14 |
Evidence: aiohue-4.9.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “philips hue control library”
- aiohueAsynchronous Python library for controlling Philips Hue lights and…
- zigpy-znpAdds support for Texas Instruments ZNP Zigbee radio modules to the…
- colorhashGenerates deterministic colors from any object by hashing its value,…
Give your agent the search over MCP, or paste the wish link into any chat.
More WWW/HTTP packages
urllib3 is an HTTP client library that provides thread-safe connection pooling, SSL/TLS verification, multipart file uploads, request retries, compression support, and proxy handling for Python applications.
Requests is a Python HTTP library that simplifies sending HTTP/1.1 requests with automatic handling of headers, authentication, cookies, and response parsing.
h11 is a pure-Python HTTP/1.1 protocol implementation that handles parsing and serializing HTTP messages without any built-in I/O, letting you integrate it with any network layer you choose.
HTTPX is a fully featured HTTP client library for Python that provides both sync and async APIs, with support for HTTP/1.1 and HTTP/2, plus an integrated command-line client.
Install it if you are building new projects or modernizing existing ones that rely on HTTP.
A minimal low-level HTTP client library that sends HTTP requests with thread-safe and task-safe connection pooling, supporting HTTP/1.1, HTTP/2, proxies, and both sync and async interfaces.
aiohttp is an async HTTP client and server framework built on asyncio, supporting both WebSockets and middleware-based routing for building concurrent web applications.
Install it if you need async HTTP client or server capabilities in asyncio-based applications.
See also aioshelly · aiounifi · pyhiveapi · pylutron-caseta · python-hpilo · hyperion-py · pyControl4 · aiocomelit · pyoverkiz · aiomodernforms