hyperion-py
Hyperion Ambient Lighting Python Package
Decision gist · record as of 2026-08-14
Yes, if you own a Hyperion-NG setup and need Python control. The library is stable, dependency-free, and directly mirrors the official JSON API, reducing the risk of breakage when Hyperion updates. The 439-day release gap is a minor concern—verify that your Hyperion server version aligns with the API docs the library targets—but the active repository and permissive license make it a safe choice for home automation or media integration projects.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.8 or later; Hyperion-NG server must be running and accessible at the specified host and port (default 19444).
- Low friction installation with no runtime dependencies.
- Maintenance status is aging—last commit was 2025-06-01 and the package has not been released for 439 days, though the repository remains active and not archived.
License · maintenance · safety
MIT (permissive) — MIT license permits commercial and private use with minimal restrictions; you may use, modify, and distribute this package freely provided you retain the license notice.
last release 2025-06-01 (439 days) · last repo commit 2025-06-01 · 14 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 74,187 downloads/mo, #14,865 on PyPI
Alternatives
Verify before relying
pip install hyperion-py
import asyncio
from hyperion import client
async def main():
async with client.HyperionClient("hyperion-host") as hc:
info = await hc.async_get_serverinfo()
print(info)
asyncio.run(main())- Whether the 439-day gap since last release indicates the package is stable or abandoned relative to ongoing Hyperion-NG server development.
- Compatibility with recent Hyperion-NG server versions and whether the JSON API alignment claim remains current.
What it is and what it does
Hyperion-py is an async Python client for Hyperion-NG, a popular ambient lighting system that drives LED strips based on screen content or manual control. The library provides a thin, direct mapping to Hyperion's JSON API—no convenience wrappers or abstraction layers—so that changes to the server's data model flow through to your code without the library becoming a bottleneck. You instantiate a HyperionClient with a host and optional port, connect asynchronously, and then call methods like async_set_color(), async_set_effect(), or async_led_stream_start() to control lighting. The library handles authentication, instance switching, and background task management for you, and supports callbacks for server-side state updates.
The package has no runtime dependencies beyond Python itself, making it lightweight to install. It supports Python 3.8 through 3.13 and is licensed under MIT. The library is aging—last released 439 days ago—but the repository remains active and the code is stable for the current Hyperion-NG API surface. If your Hyperion server version matches the JSON API documentation the library was built against, this is a straightforward way to script lighting control from Python.
Use it for
- Automate ambient lighting scenes in a home automation system by sending color or effect commands to a Hyperion-NG server.
- Stream live LED color data from a video source or custom algorithm to synchronized lighting hardware via Hyperion.
- Query and monitor Hyperion server state (brightness, active effects, component status) from a Python application.
- Build a web dashboard or mobile app backend that controls Hyperion lighting by wrapping this client.
- Integrate Hyperion lighting control into a media center or game launcher that responds to content changes.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you own a Hyperion-NG setup and need Python control.
The library is stable, dependency-free, and directly mirrors the official JSON API, reducing the risk of breakage when Hyperion updates. The 439-day release gap is a minor concern—verify that your Hyperion server version aligns with the API docs the library targets—but the active repository and permissive license make it a safe choice for home automation or media integration projects.
Install
hyperion-py on PyPI
Before you install
Low friction installation with no runtime dependencies. Maintenance status is aging—last commit was 2025-06-01 and the package has not been released for 439 days, though the repository remains active and not archived.
Requires Python 3.8 or later; Hyperion-NG server must be running and accessible at the specified host and port (default 19444).
License in practice
MIT license permits commercial and private use with minimal restrictions; you may use, modify, and distribute this package freely provided you retain the license notice.
Quickstart
pip install hyperion-py
import asyncio
from hyperion import client
async def main():
async with client.HyperionClient("hyperion-host") as hc:
info = await hc.async_get_serverinfo()
print(info)
asyncio.run(main())Verify before relying
- Whether the 439-day gap since last release indicates the package is stable or abandoned relative to ongoing Hyperion-NG server development.
- Compatibility with recent Hyperion-NG server versions and whether the JSON API alignment claim remains current.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release <4.0,>=3.8 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Aging 439 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 74,187 / month, #14,865 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Intended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Topic :: Home Automation |
Evidence: hyperion_py-0.7.6-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 › “hyperion ambient lighting control”
- hyperion-pyA Python async client library for controlling Hyperion-NG ambient…
- panda3d-simplepbrProvides a physically-based rendering (PBR) shader pipeline for…
- pylutron-casetaA Python API for controlling Lutron Caséta smart home devices via…
Give your agent the search over MCP, or paste the wish link into any chat.
More Home Automation packages
Represents and manipulates IPv4, IPv6, MAC addresses and related network objects; supports CIDR notation, subnetting, set operations, IANA lookups, and DNS reverse generation.
Home Assistant is an open-source home automation platform that centralizes control of smart home devices and automations on a local server or Raspberry Pi, prioritizing local control and privacy over cloud dependency.
Defines finite state machines and statecharts with a declarative Python API, supporting flat states, compound hierarchies, parallel regions, history states, guards, and both sync and async callbacks.
Install it if you need to model workflows, control logic, or any system with discrete states and event-driven transitions — from simple state machines to complex…
A Python library for controlling BlueZ Bluetooth adapters on Linux via the Management API, supporting both synchronous and event-driven command patterns.
An async Python library for controlling and monitoring Homematic and HomematicIP devices through multiple backend systems (CCU3, OpenCCU, Homegear, CUxD, CCU-Jack) using XML-RPC and JSON-RPC protocols.
Install it if you need to control Homematic devices from Python; the only constraint is a requirement for Python 3.14 or later and network access to a compatible…
Provides base classes and utilities for Home Assistant integrations to proxy HTTP and WebSocket traffic through Home Assistant's web server.
Install only if you are building a custom Home Assistant integration; it is not useful as a standalone package.
See also wled · aiohue · yoto-api · aioambient · directv · pywizlight · aiolifx-effects · panda3d-simplepbr · httpr · aiolifx