ab-agents-meter-reader

name	AB-Agents-Meter-Reader
description	📊 Read meter readings from photos. Electricity (day/night tariffs) and water meters. Saves history and generates messages for landlord.
version	1.0.0
author	AB-Agents
homepage	https://github.com/alexburrstudio/ab-agents-meter-reader
license	MIT
tags	["meters","utilities","readings","electricity","water","ab-agents"]
acceptLicenseTerms	true

AB Agents Meter Reader 📊

Read meter readings from photos — electricity and water meters.

Features

• ⚡ Read electricity meters (single or dual tariff)
• 💧 Read water meters (hot and cold)
• 📝 Save readings history with dates
• 📨 Generate message for landlord
• 🔄 Track multiple apartments

Setup

Requirements

• MiniMax Token Plan API key (for vision)
• Linux/macOS

Quick Start

# First run - it will ask questions
./meter-reader.sh

# Later runs - just send photos
./meter-reader.sh photo.jpg

First Run Setup

The script will ask:

1. Tenant name — your name
2. Apartment address — full address
3. Meter layout — how to tell meters apart:
   • "left=hot,right=cold" (default)
   • Or custom description

Supported Meter Types

Electricity

• Single tariff
• Dual tariff (day/night) — T1=day, T2=night
• Multi-tariff (cycle through screens)

Water

• Cold water (usually on left)
• Hot water (usually on right)
• Cubic meters (m³)

Usage

# Interactive mode (asks for photo)
./meter-reader.sh

# With photo
./meter-reader.sh /path/to/meter.jpg

# Generate message for landlord
./meter-reader.sh --message

How It Works

1. Analyzes photo using MiniMax VL API
2. Identifies meter type automatically
3. Reads the numbers
4. Saves to readings history
5. Generates formatted message

History

Readings saved to: ~/.meter-readings/history.json

Format:

{
  "apartments": {
    "address": {
      "tenant": "Name",
      "layout": "left=hot,right=cold",
      "readings": [
        {"date": "2026-04-26", "electricity_day": 8495, "electricity_night": 3008, "water_cold": 423, "water_hot": 240}
      ]
    }
  }
}

Troubleshooting

Issue	Solution
Wrong numbers	Check meter photo quality, ensure numbers are clear
Can't identify meter type	Name photo file: electricity.jpg, water.jpg
Vision error	Check MINIMAX_API_KEY is set

---

AB-Agents 🦀

Requirements

👁️ AB Agents Vision (MiniMax) — Required for image analysis. Install first:

clawhub install AB-Agents-Vision-MiniMax

---

AB-Agents 🦀