https://github.com/leomotors/home-env

Monitor Temperature and Humidity at my home using ESP32 + AHT20, Go Server, Prometheus and Grafana
https://github.com/leomotors/home-env

arduino esp32 golang prometheus-exporter sensor-data

Last synced: about 1 month ago
JSON representation

Monitor Temperature and Humidity at my home using ESP32 + AHT20, Go Server, Prometheus and Grafana

• Host: GitHub
• URL: https://github.com/leomotors/home-env
• Owner: leomotors
• License: mit
• Created: 2023-09-06T14:52:45.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2026-03-05T16:38:30.000Z (3 months ago)
• Last Synced: 2026-03-05T19:32:50.123Z (3 months ago)
• Topics: arduino, esp32, golang, prometheus-exporter, sensor-data
• Language: Go
• Homepage:
• Size: 1.94 MB
• Stars: 1
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.client.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Home Environment Monitoring System

![MIT License](https://img.shields.io/badge/License-MIT-green.svg) ![Workflow Status](https://github.com/Leomotors/home-env/actions/workflows/release.yml/badge.svg)

This repository contains a home environment monitoring system that utilizes ESP32 and AHT20 sensors to collect temperature and humidity data. The gathered information is accessible via a web interface and can be integrated with Prometheus for advanced monitoring.

## Features

- Real-time temperature and humidity monitoring

- Web interface for ~~my friend to spy me~~ easy data access

- Prometheus integration for advanced analytics

## Acknowledgments

- Special thanks to [WasinUddy](https://github.com/WasinUddy/Homelab-Environments-Monitor) for hardware recommendations and inspiration (basically ป้ายยา)

- Project Assistance: ChatGPT + GitHub Copilot

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## Stack

### On Premise (Current)

![](./images/stackv3.webp)

(Logo from https://github.com/SAWARATSUKI/ServiceLogos)

### Previous Stack

Version 1

![](./images/stack.webp)

Version 2 Software

![](./images/stackv2vlogo.webp)

### Version 2 Hardware

![](./images/board.webp)

Note: Hardware V2 remain unchanged in Software V3, it is designed to be backward compatible with existing hardware code (I'm lazy to upload Arduino Code 💀).

### Grafana Dashboard

(Old One, to be updated when I finished building Grafana Dashboard, later)

![](./images/grafana.webp)

## Discord Alert Feature

Alert when ESP32 is not sending data

### Version 1

![](./images/discord-alert.webp)

### Version 2 Canary

![](./images/discord-alert-v2.webp)

### Version 2

![](./images/discord-alert-v2-2.webp)