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

AB-Agents 🦀

Requirements

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

clawhub install AB-Agents-Vision-MiniMax

AB-Agents 🦀