Skip to content

README.md

Latest commit

 

History

History
45 lines (31 loc) · 1.57 KB

README.md

File metadata and controls

45 lines (31 loc) · 1.57 KB

MeterMonitor

AI-powered water meter reading for Home Assistant.

MeterMonitor reads analog water meters from camera images — no on-device processing required. A camera (ESP32-CAM or any Home Assistant camera entity) sends images to the MeterMonitor server, which extracts the digits using AI and publishes readings back to Home Assistant via MQTT.

What MeterMonitor does

  • Reads rotating-wheel and 7-segment water meters via camera
  • Publishes readings to Home Assistant as MQTT sensors (auto-discovery)
  • Tracks consumption history with charts
  • Corrects common misreads automatically (digit roll-over, rotation indicators)
  • Supports multiple meters and multiple camera sources

Where to start

I want to… Go to
Install MeterMonitor Installation
Set up my ESP32 camera ESP32 / Camera Setup
Configure my first meter User Guide
Adjust settings Configuration Reference
Fix a problem Troubleshooting

Requirements

Home Assistant Add-on (easiest):

  • Home Assistant OS or Supervised
  • Mosquitto broker add-on
  • amd64 or aarch64 (ARM64)

Standalone (Docker or Python):

  • Docker, or Python 3.12+
  • Any MQTT broker

Getting help

Open an issue at the GitHub repository.

Credits

Inspired by AI-on-the-edge-device. Training data by haverland/collectmeterdigits.