contas-bot

Your household bills, handled in the WhatsApp group you already use.

Everyone has that group: someone pays the electricity, drops the receipt in the chat, and then someone else scrolls up and retypes the whole checklist ("Luz ✅, Água ⬜, Aluguel ⬜…") so nobody loses track. Every month. By hand.

contas-bot takes that job. Add it to the group and it keeps the list for you: it reads every receipt, ticks the bill off, pulls the amount off the image, adds up the month, and keeps the latest list pinned at the top of the chat. Nobody installs an app, nobody learns a new tool. You keep chatting the way you already do.

🇧🇷 Feito para grupos brasileiros: o bot fala português, entende R$ 6.237,60 e lê comprovantes de Pix, boleto e cartão.

What it feels like

Gabi:  [photo of the Pix receipt] luz
Bot:   ✅
Bot:   📋 *Contas - Setembro/2026*

       ✅ Luz - R$ 231,45
       ✅ Cartão Nu - R$ 6.237,60
       ⬜ Água
       ⬜ Aluguel
       ⏸️ Academia

       *Pago:* 2/4 · *Total:* R$ 6.469,05
       📌 (pinned)

Install

You need Docker. Then paste this into a terminal:

curl -fsSL https://github.com/jeancarlos/contas-bot/releases/latest/download/install.sh | sh

Full install guide · Source on GitHub · GPL-3.0-or-later