{"id":16060835,"url":"https://github.com/geerlingguy/airgradient-prometheus","last_synced_at":"2025-04-12T21:33:52.085Z","repository":{"id":38212024,"uuid":"384254275","full_name":"geerlingguy/airgradient-prometheus","owner":"geerlingguy","description":"AirGradient Prometheus exporter.","archived":false,"fork":false,"pushed_at":"2025-01-05T21:46:24.000Z","size":87,"stargazers_count":185,"open_issues_count":3,"forks_count":60,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-04-04T01:09:27.618Z","etag":null,"topics":["air-quality","airgradient","exporter","prometheus"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/geerlingguy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"geerlingguy","patreon":"geerlingguy"}},"created_at":"2021-07-08T21:39:32.000Z","updated_at":"2025-03-31T12:02:21.000Z","dependencies_parsed_at":"2023-01-31T09:00:32.173Z","dependency_job_id":"dddadd95-9424-4aa0-8131-ae6ecbb8b6c5","html_url":"https://github.com/geerlingguy/airgradient-prometheus","commit_stats":{"total_commits":57,"total_committers":8,"mean_commits":7.125,"dds":0.5789473684210527,"last_synced_commit":"0ce3fcd851cab6105f46c652c71b8243016a2a84"},"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geerlingguy%2Fairgradient-prometheus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geerlingguy%2Fairgradient-prometheus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geerlingguy%2Fairgradient-prometheus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geerlingguy%2Fairgradient-prometheus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/geerlingguy","download_url":"https://codeload.github.com/geerlingguy/airgradient-prometheus/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248636373,"owners_count":21137439,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["air-quality","airgradient","exporter","prometheus"],"created_at":"2024-10-09T04:06:43.248Z","updated_at":"2025-04-12T21:33:52.039Z","avatar_url":"https://github.com/geerlingguy.png","language":"C++","readme":"# AirGradient - Prometheus WiFi Sketch\n\n[![Arduino CI](https://github.com/geerlingguy/airgradient-prometheus/actions/workflows/arduino.yaml/badge.svg)](https://github.com/geerlingguy/airgradient-prometheus/actions/workflows/arduino.yaml)\n\nAirGradient has a [DIY air sensor](https://www.airgradient.com/diy/). I built one (actually, more than one). I want to integrate sensor data into my in-home Prometheus instance and graph the data in Grafana.\n\nSo I built this.\n\n## How it Works\n\nIf you're using the official AirGradient Arduino sketch (`C02_PM_SHT_OLED_WIFI`), you can configure it to enable WiFi and send data to a remote server every 9 seconds (as it cycles through the display of PM2.5, CO2, temperature, and humidity values).\n\nBy default, it sends a small JSON payload to AirGradient's servers, and you can monitor the data via their service.\n\nThis project configures the AirGradient sensor for local access (instead of delivering data to AirGradient's servers), and includes two configurations:\n\n  1. [`AirGradient-DIY`](AirGradient-DIY/README.md): This is an Arduino sketch with all the code needed to set up an AirGradient sensor as a Prometheus endpoint on a WiFi network, suitable for scraping from any Prometheus instance (e.g. [geerlingguy/internet-pi](https://github.com/geerlingguy/internet-pi))\n  2. [`AirGradient-ESPHome`](AirGradient-ESPHome/README.md): This is an ESPHome configuration which integrates the AirGradient sensor with Home Assistant using ESPHome.\n\nPlease see the README file in the respective configuration folder for more information about how to set up your AirGradient sensor.\n\n## Contributing\nIf you are adding a new library or bumping the version of an existing one, update the GitHub action [Arduino CI (`arduino.yaml`)](.github/workflows/arduino.yaml) accordingly.\n\n## License\n\nMIT.\n\n## Authors\n\n  - [Jeff Geerling](https://www.jeffgeerling.com)\n  - [Jordan Jones](https://github.com/kashalls)\n  - [Falke Carlsen](https://github.com/falkecarlsen)\n\nESPHome configuration adapted from code by:\n\n  - [Andrej Friesen](https://www.ajfriesen.com)\n  - [m-reiner](https://github.com/m-reiner)\n","funding_links":["https://github.com/sponsors/geerlingguy","https://patreon.com/geerlingguy"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeerlingguy%2Fairgradient-prometheus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgeerlingguy%2Fairgradient-prometheus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeerlingguy%2Fairgradient-prometheus/lists"}