blueair_api

GitHub Release GitHub Activity License

Project Maintenance BuyMeCoffee

Api Wrapper for BlueAir API using async in python. This was inspired by this guide to be a lightweight wrapper with simple error handling.

a lot of this is based on hass-blueair.

Features

  • REST API — async device discovery, sensor polling, and control commands for both legacy and AWS-based Blueair devices.
  • MQTT real-time updates — receive sensor data and device state changes via AWS IoT WebSocket with sub-second latency instead of 5-minute polling.
  • Automatic reconnect with credential refresh — MQTT tokens expire after 24 hours; the client refreshes credentials and reconnects with exponential backoff on unexpected disconnects.
  • Split AWS regions when needed — keep the normal single region setting for most accounts, or configure separate Gigya account and BlueCloud device-control regions for accounts whose devices are hosted elsewhere. See AWS account and BlueCloud regions.
  • Data-driven SKU mapping — resolves device SKUs to human-readable product names via a built-in lookup table.
  • Per-device hardware detection — mood_brightness_max and fan_speed_count adapt automatically based on the device's hardware identifier.

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for dahlb from gravatar.com dahlb

Credits

Author: Brendan Dahl

License

MIT License

Requires

Python <4, >=3.12.0

Tags

hatch rest-mini api

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

blueair_api-1.56.1.tar.gz (60.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

blueair_api-1.56.1-py3-none-any.whl (40.6 kB view details)

Uploaded Python 3

File details

Details for the file blueair_api-1.56.1.tar.gz.

File metadata

  • Download URL: blueair_api-1.56.1.tar.gz
  • Upload date:
  • Size: 60.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.25

File hashes

Hashes for blueair_api-1.56.1.tar.gz
Algorithm Hash digest
SHA256 070da671a2577677590ebf0c1efda91410dffe7b6c73171b1f32385e8d0bd0b4
MD5 69b00998c8c54d62d0c735af646752c4
BLAKE2b-256 3a8d65eefa45977c141416b03c096fb3f433af5e4aae7d082f92ffc32e3fda24

See more details on using hashes here.

File details

Details for the file blueair_api-1.56.1-py3-none-any.whl.

File metadata

  • Download URL: blueair_api-1.56.1-py3-none-any.whl
  • Upload date:
  • Size: 40.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.25

File hashes

Hashes for blueair_api-1.56.1-py3-none-any.whl
Algorithm Hash digest
SHA256 5e4a33fcd49308c5441f273432fe1b7236c5b64280559234d363c4e5972a8ac4
MD5 380874ddc691b87098900dea6b6fe1da
BLAKE2b-256 7a674bff7cbacb2f159f986d936fead901aeee76c7302f5cc6f447d2d78f918f

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

1.56.1 This release

2 files

1.56.0

2 files

1.55.0

2 files

1.54.0

2 files

1.53.0

2 files

1.52.0

2 files

1.51.0

2 files

1.50.4

2 files

1.50.3

2 files

1.50.2

2 files

1.50.1

2 files

1.50.0

2 files

1.49.1

2 files

1.49.0

2 files

1.48.6

2 files

1.48.5

2 files

1.48.4

2 files

1.48.3

2 files

1.48.2

2 files

1.48.1

2 files

1.48.0

2 files

1.47.3

2 files

1.47.2

2 files

1.47.1

2 files

1.47.0

2 files

1.46.0

2 files

1.45.2

2 files

1.45.1

2 files

1.45.0

2 files

1.44.1

2 files

1.44.0

2 files

1.43.0

2 files

1.42.0

2 files

1.41.0

2 files

1.40.1

2 files

1.40.0

2 files

1.39.0

2 files

1.38.1

2 files

1.38.0

2 files

1.37.0

2 files

1.36.5

2 files

1.36.4

2 files

1.36.3

2 files

1.36.2

2 files

1.36.1

2 files

1.36.0

2 files

1.35.0

2 files

1.34.2

2 files

1.34.1

2 files

1.34.0

2 files

1.33.2

2 files

1.33.1

2 files

1.33.0

2 files

1.32.0

2 files

1.31.3

2 files

1.31.2

2 files

1.31.1

2 files

1.31.0

2 files

1.30.2

2 files

1.30.1

2 files

1.30.0

2 files

1.29.0

2 files

1.28.0

2 files

1.27.0

2 files

1.26.3

2 files

1.26.2

2 files

1.26.1

2 files

1.26.0

2 files

1.25.0

2 files

1.24.1

2 files

1.24.0

2 files

1.23.0

2 files

1.22.0

2 files

1.21.1

2 files

1.21.0

2 files

1.20.1

2 files

1.20.0

2 files

1.19.0

2 files

1.18.1

2 files

1.18.0

2 files

1.17.0

2 files

1.16.0

2 files

1.15.2

2 files

1.15.1

2 files

1.15.0

2 files

1.14.0

2 files

1.13.0

2 files

1.12.1

2 files

1.12.0

2 files

1.11.0

2 files

1.10.0

2 files

1.9.6

2 files

1.9.5

2 files

1.9.4

2 files

1.9.3

2 files

1.9.2

2 files

1.9.1

2 files

1.9.0

2 files

1.8.9

2 files

1.8.8

2 files

1.8.7

2 files

1.8.6

2 files

1.8.5

2 files

1.8.4

2 files

1.8.3

2 files

1.8.2

2 files

1.8.1

2 files

1.8.0

2 files

1.7.0

2 files

1.6.2

2 files

1.6.1

2 files

1.6.0

2 files

1.5.1

2 files

1.5.0

2 files

1.4.0

2 files

1.3.0

2 files

1.2.0

2 files

1.1.0

2 files

1.0.0

2 files

0.1

2 files

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