zwave-js-server-python

What it is and what it does

This is a Python client for zwave-js-server, a separate Z-Wave control daemon. It provides async-first bindings to send commands and receive state updates from Z-Wave devices via WebSocket, structuring the API around Driver, Controller, and Node objects that match the underlying Z-Wave JS architecture. The library is designed for home automation integrations and tools that need to query or control Z-Wave networks remotely.

It depends on aiohttp for WebSocket communication and pydantic for data validation. The library supports Python 3.12 and later, has no known security vulnerabilities, and is actively maintained. It includes helpers for access control operations (credential management) and can be invoked from the command line to inspect server state or version.

Use it for:

• Build a home automation dashboard that queries Z-Wave device state and sends control commands.
• Integrate Z-Wave device management into Home Assistant or similar platforms via the zwave-js-server bridge.
• Monitor Z-Wave network health and device status from a remote Python application.
• Automate Z-Wave device control based on external events or schedules in a larger automation system.
• Develop custom Z-Wave access control workflows using the typed access-control API.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Python client library for communicating with zwave-js-server over WebSocket, providing Driver, Controller, and Node classes that mirror the Z-Wave JS event and state structure.

Yes. This is a well-maintained, actively developed library with low install friction, no security issues, and a permissive license. Install it if you need to communicate with a zwave-js-server instance from Python; it is the standard client for that purpose. The only prerequisite is having a zwave-js-server running and accessible over the network.

Install

zwave-js-server-python on PyPI

pip install zwave-js-server-python

uv add zwave-js-server-python

poetry add zwave-js-server-python

Installing zwave-js-server-python

Before you install

Low friction: pure Python wheel with only two runtime dependencies (aiohttp and pydantic). Actively maintained with a recent release and no known vulnerabilities.

License in practice

Apache-2.0 permissive license allows commercial and private use with minimal restrictions; suitable for most projects.

Quickstart

pip install zwave-js-server-python

import asyncio
from zwave_js_server.client import Client

async def main():
    client = Client("ws://localhost:3000")
    result = await client.async_send_command({"command": "start_listening"})

asyncio.run(main())

Requires a running zwave-js-server instance accessible at the specified WebSocket URL; Python 3.12 or later.

Verify before relying

• Whether the library supports Z-Wave JS versions beyond 1.x or has version compatibility constraints.
• Performance characteristics when managing large numbers of Z-Wave devices or nodes.
• Whether access control features (Schema 48) are required for typical use cases or optional.

Package facts

Evidence: zwave_js_server_python-0.73.0-py3-none-any.whl

Keywords: home, automation, zwave, zwave-js

Tags

More Home Automation packages