---
id: zwave-js-server-python
version: "0.73.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# zwave-js-server-python — Python wrapper for zwave-js-server

License: permissive · Maintenance: active · Downloads: 89.5K/mo

## 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 above — 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

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

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 89.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

zwave js server python client, z-wave home automation library, zwave device control python, websocket zwave communication, home assistant zwave integration, zwave node controller python, zwave device state management, home-automation, zwave, websocket-client

[View on SkillFed](https://skillfed.io/packages/zwave-js-server-python) · [View on PyPI](https://pypi.org/project/zwave-js-server-python/)