Skill: alexburrstudio/ab-agents-meter-reader (version 1.0.4)

--- 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 ```bash # 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 ```bash # 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: ```json { "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)](https://github.com/alexburrstudio/ab-agents-vision)** — Required for image analysis. Install first: ```bash 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](https://t.me/AlexBurrOne) | [Канал AB Agents](https://t.me/alexburr_agents)*


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (CRITICAL)