AB-Agents-Meter-Reader

📊 Read meter readings from photos. Electricity (day/night tariffs) and water meters. Saves history and generates messages for landlord.

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 🦀

💰 Support / Поддержать

Если оказалось полезно — задонать на пиво или кофе:

🥝 TON: UQDHLFkZo0dJzYLm7QJr6Xx8iKvrrailZa2eXdX41dvRlyfr
🥝 USDT TRC20: TE1mVDUueHmhHNF57x1PZfEkAe6qgorHZc
💳 T-BANK: https://www.tbank.ru/cf/3CfaY0mpVIt

🦀 Сделано вручную и с любовью к автоматизации. Поддержи, чтобы следующий скилл появился быстрее.

⚡ 2,847 установок. Донатят — единицы. Ты не будешь одним из них? 😏

💬 "Перестал заморачиваться с показаниями вручную. Спасибо." — реальный отзыв.

🚧 Следующий скилл в разработке: автоматический постинг в Telegram. Проголосуй за функцию на GitHub — получишь бесплатно.

🦀 Делаю соки и код. Соки — бизнесу, код — вам бесплатно. Поддержи.

💰 Каждый донат = мотивация выпустить следующий релиз быстрее. Тонко намекаю.

🔥 Скилл сэкономил тебе минимум 15 минут? Купи мне кофе — я заслужил.

---

by Alex Burr | Канал AB Agents