Airly Integration for Home Assistant

S.C.O.R.E. → Safety → Security

Overview

The Airly integration allows homeowners to monitor air quality in real-time, providing crucial data on pollutants and environmental conditions. This capability enhances the safety and health of residents by enabling proactive responses to poor air quality.

Benefits

• Receive real-time air quality alerts to ensure a healthy home environment.
• Integrate air quality data into home capability routines for better indoor air management.
• Empower family members to make informed decisions about outdoor activities based on air quality.

Intent

The purpose of this capability is to seamlessly integrate Airly’s air quality data into Home Assistant, allowing users to monitor and respond to air quality changes. The outcome is a safer living environment with actionable insights on pollution levels.

Preconditions

• Home Assistant installed and configured.
• Airly API access credentials.
• Internet connection for real-time data retrieval.
• Integration available and authenticated: Zigbee2MQTT.
• Device installed and reachable: Smoke Detector and Alarm Trigger.

Actors

• Homeowner monitoring air quality
• Family members affected by pollution
• Guests concerned about environmental conditions

Trigger

The capability is triggered by scheduled updates from the Airly API or by significant changes in air quality readings.

Workflow Diagram

flowchart TD
    A[Air Quality Reading Update] -->|check| B{Is Air Quality Poor?}
    B -->|Yes| C[Send Alert to Homeowner]
    C --> D[Update Home Capability]
    B -->|No| E[Exit]

Workflow Description

1. Fetch Air Quality Data

Home Assistant requests the latest air quality data from the Airly API.

2. Evaluate Air Quality Levels

The system checks if the air quality index (AQI) exceeds predefined thresholds.

3. Notify Residents

If the air quality is poor, alerts are sent to the homeowner and family members via notifications.

4. Automate Responses

Depending on the air quality readings, the system can initiate actions such as activating air purifiers.

5. Log Data for Review

All air quality data is logged for future reference and analysis.

Postconditions

The system updates the air quality status in Home Assistant and notifies relevant individuals if pollution levels are high, ensuring everyone is informed.

Optional Enhancements

• Integrate with smart air purifiers for automated response to poor air quality.
• Create historical reports on air quality trends for better long-term monitoring.
• Add voice alerts through smart speakers for real-time notifications.

Recommended Components

Source Examples

• 2026.1: Home is where the dashboard is ?? – Home Assistant (homeassistant)