Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

py-atmos-wg1000

Async Python library for the local WebSocket API of an ATMOS WG1000 gateway. It is the data layer for a future Home Assistant integration: a heavy catalog at configuration time, and a light value feed at runtime.

PyPI name: py-atmos-wg1000 (PyPI rejected py-atmos / pyatmos as too similar to the existing pyatmos project). Import as import pyatmos_wg1000.

Status: early. The frame codec, language tables, and register poller are in place. Writes to the boiler are encoded but have not been sent to a live gateway.

Install

pip install py-atmos-wg1000

Two paths

Configuration (heavy)

Download Lang.json and texty_brana.json, pick a language by column code (POL) or by the gateway index in USER1_LANG, and resolve labels. This is pyatmos_wg1000.i18n.LanguageCatalog. Drop it after the entities exist.

Runtime (light)

Keep one WebSocket, log in, and poll a fixed set of register ids. pyatmos_wg1000.feed.AtmosFeed stores raw words and publishes pyatmos_wg1000.feed.RegisterUpdate only when a word changes. It does not load the language files.

The gateway does not push temperatures. The socket stays open and the feed asks again on an interval. The panel uses 30 seconds for circuit temperatures.

Credentials

Copy .env.example to .env. The real file is gitignored.

PYATMOS_URL=https://192.168.0.10
PYATMOS_USER=user
PYATMOS_PASSWORD=secret

Development

Python 3.13. Version comes from git tags (hatch-vcs), with fallback 0.0.0 until the first tag. See CONTRIBUTING.md, AGENTS.md, and SECURITY.md.

uv sync --group dev --group test --locked
uv run pre-commit install --hook-type pre-commit --hook-type pre-push
uv run --group dev --group test poe validate

Metadata

Release files for py-atmos-wg1000 2026.9.0b8

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for py-atmos-wg1000 2026.9.0b8
File Size Uploaded
py_atmos_wg1000-2026.9.0b8.tar.gz 149.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for py-atmos-wg1000 2026.9.0b8
File Interpreter ABI Platform
py_atmos_wg1000-2026.9.0b8-py3-none-any.whl Python 3 none any Details

Total release size: 184.6 kB

Release files / py_atmos_wg1000-2026.9.0b8.tar.gz

Download URL py_atmos_wg1000-2026.9.0b8.tar.gz
Size 149.7 kB
Tags Source
SHA-256 checksum
How to use checksums
0f86d7219a51a2b8f593e6812c8ceaca2b9babf6a543fc4d68072bb28a4b6067
BLAKE2b-256 checksum
How to use checksums
7362e02432c89000d94e3342ba688b81e3084a1ad34fa28433d503ecfc2c3686
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.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 Sep 26, 2026.

Transparency log

Release files / py_atmos_wg1000-2026.9.0b8-py3-none-any.whl

Download URL py_atmos_wg1000-2026.9.0b8-py3-none-any.whl
Size 34.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6ea43d04c0186aeac4b94095307fc49f496a3937c37ed04adb8d01d4260ef7d8
BLAKE2b-256 checksum
How to use checksums
f12faea7ba7ed318581b19d6b291a51d2377eb6f886ac10c34b16280a0fb9c36
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.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 Sep 26, 2026.

Transparency log
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page