vallox-websocket-api
Vallox WebSocket API
Decision gist · record as of 2026-08-14
Yes, if you own a compatible Vallox ventilation unit and need programmatic control. The package is actively maintained, has low install friction, and provides a complete async interface to the device's WebSocket API. The LGPL 3 copyleft license is a constraint only if you plan to distribute proprietary derivatives. No known security vulnerabilities. Verify your unit model is supported before committing.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.9.0 or newer.
- Vallox unit must be connected to LAN with firmware 2.0.0 or newer recommended.
- Low install friction with pure-Python dependencies (websockets, construct, aiohttp).
License · maintenance · safety
LGPL 3 (copyleft) — Licensed under LGPL 3 (copyleft). Any derivative work or bundled distribution must also be open-source under compatible terms; proprietary applications cannot incorporate this code without releasing their own source.
last release 2026-07-10 (35 days) · last repo commit 2026-07-20 · 32 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 73,654 downloads/mo, #14,954 on PyPI
Alternatives
Verify before relying
import asyncio
from vallox_websocket_api import Vallox, Profile
client = Vallox('192.168.1.10')
async def run():
data = await client.fetch_metric_data()
await client.set_profile(Profile.HOME)
asyncio.run(run())- Exact list of settable vs. read-only metrics beyond the documented examples
- Compatibility confirmation for all listed unit models (tested only on Vallox 145 MV and 270 MV)
- Behavior and error handling when unit is offline or unreachable
What it is and what it does
vallox-websocket-api is an async Python client for remote control and monitoring of Vallox ventilation units over WebSocket. It wraps the same API that Vallox's own web interface uses, allowing you to set operating profiles (Home, Away, Auto, Fireplace, Extra), adjust fan speeds and target temperatures, fetch real-time metrics like air temperatures and humidity, and retrieve historical logs stored on the device. The package requires Python 3.9.0+ and depends on websockets, construct, and aiohttp for async HTTP and binary protocol handling.
The library is designed for LAN-connected units running firmware 2.0.0 or newer. It has been tested on Vallox 145 MV and 270 MV models but claims compatibility with a broad range of Vallox, Airflow, and Helios ventilation units. Most metrics are read-only, but you can set profile-specific fan speeds, target temperatures, and timer values; unsettable addresses can be manually marked as settable if needed.
Use it for
- Automate ventilation profile switching based on occupancy or time-of-day schedules in a smart home
- Monitor real-time temperature and air quality metrics from a Vallox unit in a monitoring dashboard
- Integrate ventilation control into a home automation framework that manages HVAC alongside other systems
- Retrieve and log historical temperature data from the unit for energy analysis or troubleshooting
- Adjust fan speeds and target temperatures remotely without accessing the unit's physical interface
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you own a compatible Vallox ventilation unit and need programmatic control.
The package is actively maintained, has low install friction, and provides a complete async interface to the device's WebSocket API. The LGPL 3 copyleft license is a constraint only if you plan to distribute proprietary derivatives. No known security vulnerabilities. Verify your unit model is supported before committing.
Install
vallox-websocket-api on PyPI
Before you install
Low install friction with pure-Python dependencies (websockets, construct, aiohttp). Actively maintained with recent releases; last commit 2026-07-20 and 35 days since latest release indicate ongoing development.
Requires Python 3.9.0 or newer. Vallox unit must be connected to LAN with firmware 2.0.0 or newer recommended.
License in practice
Licensed under LGPL 3 (copyleft). Any derivative work or bundled distribution must also be open-source under compatible terms; proprietary applications cannot incorporate this code without releasing their own source.
Quickstart
import asyncio
from vallox_websocket_api import Vallox, Profile
client = Vallox('192.168.1.10')
async def run():
data = await client.fetch_metric_data()
await client.set_profile(Profile.HOME)
asyncio.run(run())Verify before relying
- Exact list of settable vs. read-only metrics beyond the documented examples
- Compatibility confirmation for all listed unit models (tested only on Vallox 145 MV and 270 MV)
- Behavior and error handling when unit is offline or unreachable
Package facts
| License | LGPL 3 copyleft |
| Python support | Supports the current Python release <4,>=3.9.0 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 3 packageswebsocketsconstructaiohttp |
| Maintenance | Actively maintained 35 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 73,654 / month, #14,954 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableIntended Audience :: DevelopersLicense :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)Operating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: 3.9 |
Evidence: vallox_websocket_api-6.1.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 › “vallox ventilation control”
- vallox-websocket-apiAsync WebSocket client for controlling and monitoring Vallox…
- pystiebeleltronProvides a Python API to communicate with STIEBEL ELTRON ISG web…
- controlImplements core operations for analyzing and designing feedback…
Give your agent the search over MCP, or paste the wish link into any chat.
More Networking packages
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.
psutil retrieves real-time information about running processes and system resources (CPU, memory, disks, network, sensors) across multiple operating systems, enabling system monitoring, process profiling, and resource management.
pyOpenSSL wraps OpenSSL's SSL/TLS functionality for Python, providing high-level connection objects and certificate handling through a Python-friendly interface around OpenSSL's cryptographic operations.
uvloop is a drop-in replacement for Python's built-in asyncio event loop, implemented in Cython and using libuv, that accelerates async I/O operations.
execnet lets you spawn and communicate with Python interpreters across local processes, remote hosts, and different platforms, using a simple API for task distribution and inter-process messaging.
However, the aging maintenance status (275 days since last release) means you should verify it meets your concurrency and performance needs before committing to a…
PyZMQ provides Python bindings for ZeroMQ (ØMQ), a lightweight messaging library that enables fast, asynchronous communication between distributed processes and applications.
See also pystiebeleltron · intellifire4py · pydaikin · aioairq · py-ccm15 · fjaraskupan · aiomodernforms · aioairzone-cloud · httpx-ws · devolo-home-control-api