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.0b7

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.0b7
File Size Uploaded
py_atmos_wg1000-2026.9.0b7.tar.gz 149.3 kB Details

Built distribution (wheel)

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

Total release size: 184.1 kB

Release files / py_atmos_wg1000-2026.9.0b7.tar.gz

Download URL py_atmos_wg1000-2026.9.0b7.tar.gz
Size 149.3 kB
Tags Source
SHA-256 checksum
How to use checksums
3b6b7182982271877a731ff3b5b6f9882999fb889508e9e1ed20185b6bec9135
BLAKE2b-256 checksum
How to use checksums
a929539cd38b8af91c96e92c5a87596da0977adb27e9bccf70d3fcf32ef5ad9a
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.0b7-py3-none-any.whl

Download URL py_atmos_wg1000-2026.9.0b7-py3-none-any.whl
Size 34.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ad14b08eda15d0f49a85815ac6cdcb23d0e7f6f6f2c926f7cdc2ef376c557c59
BLAKE2b-256 checksum
How to use checksums
e9b9a6a6d94ace5677909caa89cdc3a336f9bc2bc183f14c0adef58466292b5a
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