Developers

Air quality in Home Assistant

The integration adds your city's air quality to Home Assistant as sensors refreshed every 15 minutes. Show them on dashboards and use them in automations, for example to turn on an air purifier or to close the windows. No account or key.

Install

From the Marketplace: in Home Assistant 2026.11 and later open Settings → Marketplace, find “Atmy” and select Install — the setup opens right away, no restart needed. The button below opens the integration directly. In older versions, find “Atmy” in HACS, select Download and restart Home Assistant.

Open in the Marketplace Source code on GitHub

Manually: download the archive, copy the atmy folder into config/custom_components/ and restart Home Assistant.

Download the integration

Add a city

Settings → Devices & services → Add integration → Atmy. Leave the field empty to use the city nearest to your home, or type a city name in any language. Add the integration again for each more city.

Sensors

  • pm2_5 — the city's mean PM2.5 now, µg/m³
  • us_aqi — the US EPA air quality index
  • air_quality — the level from good to hazardous
  • pm2_5_yesterday — the mean of the last completed day
  • pollution_accumulation — 0–100, how strongly the weather keeps particles near the ground, with the next 24 hours in the attributes
  • temperature, humidity, pressure, wind_speed, wind_gusts — the weather now from Atmy's records

Automation example

Turn on the air purifier when PM2.5 in the city stays above 35 µg/m³ for half an hour:

automation:
  - alias: Air purifier when the city air is bad
    triggers:
      - trigger: numeric_state
        entity_id: sensor.berlin_germany_pm2_5
        above: 35
        for: "00:30:00"
    actions:
      - action: fan.turn_on
        target:
          entity_id: fan.air_purifier

The values are approximate: low-cost optical sensors after the Data Hub quality check, not official monitoring. How the values are computed: methodology