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:
- Tenant name — your name
- Apartment address — full address
- 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
- Analyzes photo using MiniMax VL API
- Identifies meter type automatically
- Reads the numbers
- Saves to readings history
- 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