Tus finanzas, en un mensaje de Telegram.
Un bot que registra tus gastos e ingresos como si le escribieras a un amigo: texto, fotos de tickets, PDFs o notas de voz. Todo se guarda en tu propia máquina — SQLite, CSV y un reporte HTML con gráficas y proyecciones. Sin APIs de pago, sin nube obligatoria, sin regalar tus datos.
Las finanzas personales fallan por fricción.
Lo construí para mi propia familia: si anotar un gasto cuesta más de cinco segundos, no se anota. Y si tus datos financieros viven en la app de un tercero, no son del todo tuyos.
Las apps de finanzas piden demasiado
Cuentas bancarias conectadas, suscripciones, tus datos en servidores ajenos. Aquí todo vive en tu ordenador: la base de datos, los tickets y los reportes.
El Excel se abandona en dos semanas
Nadie abre una hoja de cálculo en el supermercado. Pero Telegram ya está abierto: escribes "gasto 12,50 mercadona" y sigues con tu vida.
Los tickets se pierden
Foto al ticket y listo: queda guardado, vinculado a su movimiento y organizado en carpetas mensuales. Trazabilidad completa de cada euro.
Tus datos, tu máquina, tu control.
El mismo criterio que aplico en consultoría: la tecnología correcta es la que puedes entender, mantener y controlar. Este proyecto lo demuestra con código.
Nada sale de tu ordenador
SQLite local, tickets en tus carpetas, sincronización opcional con Google Drive de escritorio — sin usar su API.
Sin APIs de pago
Las notas de voz se transcriben con Whisper en local y los tickets se leen con OCR local. Ninguna suscripción necesaria.
Nada se registra sin revisión
Fotos, PDFs y audios ambiguos van a una bandeja de pendientes. Tú decides qué se convierte en movimiento contable.
Reporte que responde preguntas
Gasto por categoría, tendencia de 12 meses, proyecciones de meses futuros y avisos cuando algo se asumió con dudas.
Del mensaje al reporte, sin caos.
Un flujo simple pensado para usarse todos los días — y para que lo use más de una persona: soporta varios usuarios autorizados de la misma familia o equipo.
Escribes al bot
Texto rápido ("gasto 12,50 mercadona comida"), una foto del ticket, un PDF o una nota de voz. El parser entiende hasta importes hablados: "spotify veintidós euros".
El bot clasifica y guarda
Los mensajes claros se registran al instante en SQLite con su categoría. Lo ambiguo queda en la bandeja de pendientes, con el archivo original conservado.
Revisas los pendientes
Tickets y audios se revisan cuando tú quieras — con OCR y Whisper locales o manualmente. Cada movimiento queda enlazado a su justificante.
Ves el panorama completo
Reporte HTML con filtros y gráficas, panel local editable, y proyecciones mensuales que se marcan como pagadas automáticamente cuando llega el movimiento real.
Clónalo, úsalo y hazlo tuyo.
El proyecto completo está en GitHub con instrucciones paso a paso: creas tu bot con @BotFather, configuras tu archivo de entorno y en minutos tienes tus finanzas funcionando en tu propia máquina. Si lo adaptas o lo mejoras, me encantará saberlo.
Hecho para mi familia. Compartido para la tuya.