---
title: "AirGradient"
description: "AirGradient is a built-in integration for Home Assistant. It has 2.7k installs sharing analytics and works locally."
canonical: "https://vulpo.app/integrations/core/airgradient"
url: "https://vulpo.app/integrations/core/airgradient.md"
last-updated: "2026-10-22"
version: "1.4"
---

# AirGradient

> AirGradient is a built-in integration for Home Assistant. It has 2.7k installs sharing analytics and works locally.

AirGradient is a built-in integration that connects AirGradient air quality monitors to Home Assistant over the local network. It adds sensors for readings such as battery and input voltage, NOx index and particulate matter, along with sensors that report the device's current display and LED settings. Settings can be changed from Home Assistant through numbers for display and LED bar brightness and measurement interval, and selects for LED modes, temperature unit, PM standard, GPS mode and index learning offsets. Buttons start CO2 sensor calibration and test the LED bar, while switches control the buzzer, the cloud connection and posting data to AirGradient. Update entities are also provided. Devices can be found automatically on the network, and setup in the UI asks for the device hostname or IP address.

Automatic summary of Home Assistant's source code. Something wrong? [Get in touch](https://vulpo.app/contact)

[Open in My Home Assistant](https://my.home-assistant.io/redirect/config_flow_start/?domain=airgradient)

## Supports

- **Works locally**: Talks to your devices on your own network. No vendor cloud in between.
- **Set up in the UI**: Add it in Settings, Devices and services. Nothing to download.
- **Found by itself**: Home Assistant spots it on the network and offers to add it.
- **Change settings later**: Its connection settings can change without removing it.
- **Platinum quality**: Home Assistant's own rating of its code and setup experience.
- **Updated with Home Assistant**: Ships and updates with every Home Assistant release.

## Setting it up

Home Assistant usually finds it on the network and offers to add it. It can also be added by hand under Settings, Devices and services.

### Connect

- **Host**: The hostname or IP address of the Airgradient device.

Texts from Home Assistant's source code, [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0).

## Entities

- **Buttons**: Calibrate CO2 sensor, Test LED bar
- **Numbers**: Display brightness, LED bar brightness, Measurement interval
- **Selects**: Back LED brightness, CO2 automatic baseline duration, Configuration source, Display PM standard, Display temperature unit, Front LED brightness, GPS mode, LED bar mode, NOx index learning offset, Touch LED intensity, VOC index learning offset
- **Sensors**: Battery percentage, Battery voltage, Input voltage, Carbon dioxide automatic baseline calibration, Display brightness, Display PM standard, Display temperature unit, LED bar brightness, LED bar mode, NOx index, NOx index learning offset, PM0.3, and 10 more
- **Switches**: Buzzer, Cloud connection, Post data to Airgradient

## Troubleshooting

- **Diagnostics**: Downloads a diagnostics file to attach to a bug report.

## At a glance

- Kind: Built-in integration
- Category: [Sensors](https://vulpo.app/integrations/category/sensors.md), Air quality
- Brand: [AirGradient](https://vulpo.app/integrations/airgradient.md)
- Number: 2.7k installs sharing analytics
- Connection: Works locally
- Upkeep: Part of Home Assistant
- Needs: Built into Home Assistant
- Quality scale: Platinum quality scale
- Domain: `airgradient`
- Source: <https://www.home-assistant.io/integrations/airgradient/>

In Vulpo: Quick Toggle card, Button card, Select card, Chart card, Apple Watch, Control Center

## Other ways in for AirGradient

| Name | Kind | Installs or stars | Connection | Upkeep |
| --- | --- | --- | --- | --- |
| [AirGradient Public Location](https://github.com/keranm/airgradient-public) | Marketplace integration | 3 installs sharing analytics | Needs the vendor's cloud | Updated in the last 6 months |

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about)

Last updated 2026-10-22. Source: https://vulpo.app/integrations/core/airgradient

---

- HTML version of this page: https://vulpo.app/integrations/core/airgradient
- Site index for agents: https://vulpo.app/llms.txt
- Everything in one document: https://vulpo.app/llms-full.txt
- All pages: https://vulpo.app/sitemap.xml