PyISY
Python library for the Universal Devices ISY-994, Polisy, and eisy controllers.
This library allows for easy interaction with ISY nodes, programs, variables, and the network module. It provides asynchronous communication and supports near real-time updates via WebSocket or SOAP event streams.
The full documentation is available at https://pyisy.readthedocs.io.
Features
- Asynchronous communication via
asyncioandaiohttp. - Support for ISY-994 (v4 and v5 firmware), Polisy, and eisy.
- Automatic updates from the device via WebSocket or SOAP.
- Interaction with nodes, groups, programs, variables, and networking modules.
- Command-line interface for quick testing and monitoring.
Installation
pip install pyisy
Quick Start
You can test the connection to your ISY directly from the command line:
python3 -m pyisy http://your-isy-url:port username password
Basic Usage
import asyncio
from pyisy import ISY
async def main():
# Connect to ISY controller
isy = ISY("192.168.1.10", 80, "admin", "password")
# Initialize the connection and download information
await isy.initialize()
# Get a node by its address
node = isy.nodes["1A 2B 3C 1"]
print(f"Node Name: {node.name}")
print(f"Node Status: {node.status}")
# Turn a node on
await node.turn_on()
# Shutdown the connection
await isy.shutdown()
if __name__ == "__main__":
asyncio.run(main())
Development
Contributions are welcome! This project uses pre-commit to ensure code quality.
Setup
# Clone the repository
git clone https://github.com/automicus/PyISY.git
cd PyISY
# Install development + test dependencies
pip install -r requirements.txt -r requirements-dev.txt -r requirements-test.txt
pip install -e .
# Install pre-commit hooks
pre-commit install
We use ruff for formatting and linting. You can run it manually:
ruff check .
ruff format .
A VSCode DevContainer is also provided for a consistent development environment.
Tests
PyISY has an offline pytest suite covering the XML parsers, connection
behavior, the full ISY.initialize() lifecycle, and the per-node /
per-program action methods used by the Home Assistant isy994
integration. The fixtures are anonymized real-controller exports —
running the suite needs no live ISY.
Please run the tests before opening a PR. They are fast (~10 s) and catch most regressions in the public API that Home Assistant Core depends on.
# Run the full suite
pytest
# Run with a coverage report
pytest --cov=pyisy --cov-report=term-missing
# Run a single file or test
pytest tests/test_nodes.py
pytest tests/test_climate_lock.py::test_set_climate_setpoint_heat_doubles_for_uom_101
The same pytest job runs in CI on Python 3.11 and 3.14 (matching the
range Home Assistant supports). The terminal coverage report is visible
in the workflow logs.
If you change parsing or status behavior, be ready to refresh snapshots:
pytest --snapshot-update
Snapshots live under tests/__snapshots__/ and are tracked in git.
Releases
Detailed change logs are available on the GitHub Releases page.
Credits
- Ryan Kraus (@rmkraus) - Creator
- Tim (@shbatm) - lead Maintainer
- Greg Laabs (@overloadut) - Maintainer
4 maintainers
Release files for pyisy 3.7.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pyisy-3.7.0.tar.gz | 148.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pyisy-3.7.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 226.9 kB
Release files / pyisy-3.7.0.tar.gz
| Download URL | pyisy-3.7.0.tar.gz |
|---|---|
| Size | 148.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9cbf92c7bb6556cbdf11947a22373414a0c873613ba099305af673659084abe9
|
|
BLAKE2b-256 checksum How to use checksums |
d830c66774517c63c541247c2f25808aa358090191b0fa20cbd91d4bed8eb19c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 21, 2026.
Transparency logRelease files / pyisy-3.7.0-py3-none-any.whl
| Download URL | pyisy-3.7.0-py3-none-any.whl |
|---|---|
| Size | 78.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e68d8041921ae4dcc4d81b337c9485cf7f82c974312571ac1253774502cfdac5
|
|
BLAKE2b-256 checksum How to use checksums |
a724e8c8cbe2612b7a934ce5b241daaff8be40f09d17fc524fb9407f1aa9d7c5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 21, 2026.
Transparency log
