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: stable (2026.10.1). The frame codec, language tables, Info dump, register poller, and stock Pages.js poll-interval parser are in place. Writes to the boiler are encoded.
Install
pip install py-atmos-wg1000Two 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. Stock panel cadence is in Pages.js (PrmID1s … PrmID30s); parse_pages_js_hod16_intervals reads it. The Informace page requests Info dumps every 1 s (INFO_PAGE_POLL_INTERVAL). Circuit room temperatures on the homepage use the 30 s bucket.
Credentials
Copy .env.example to .env. The real file is gitignored.
PYATMOS_URL=https://192.168.0.10
PYATMOS_USER=user
PYATMOS_PASSWORD=secretDevelopment
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 validate1 maintainer
Metadata
1 maintainer
Release files for py-atmos-wg1000 2026.10.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| py_atmos_wg1000-2026.10.1.tar.gz | 156.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| py_atmos_wg1000-2026.10.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 195.4 kB
Release files / py_atmos_wg1000-2026.10.1.tar.gz
| Download URL | py_atmos_wg1000-2026.10.1.tar.gz |
|---|---|
| Size | 156.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a2b6ebf942735473977f4d252b0633f0593a3eac23539eb4c9577540184cef05
|
|
BLAKE2b-256 checksum How to use checksums |
abd64d19a6ca28293dbba5a8ce3f2195fbcb9dd6fac947588bbecc92bf5ac565
|
| 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 Oct 4, 2026.
Transparency logRelease files / py_atmos_wg1000-2026.10.1-py3-none-any.whl
| Download URL | py_atmos_wg1000-2026.10.1-py3-none-any.whl |
|---|---|
| Size | 39.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
08d16a56725c4a0cbb3a138505c5fd461a999264a7c0579939efd2ab00e4197d
|
|
BLAKE2b-256 checksum How to use checksums |
ce6cb7a65ce437c96933156be18d7a76f6df7ebcee1a04fdbee9aa371d92dc80
|
| 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 Oct 4, 2026.
Transparency log
