← Voltar

Plin

Bot funcional com self-hosting em homelab próprio

Python SQLAlchemy Docker Telegram API CasaOS

O Problema

Aplicativos de finanças pessoais têm telas demais para quem só quer registrar um gasto no momento em que ele acontece. O Plin resolve isso de forma direta: o usuário registra entradas e saídas pelo Telegram, sem abrir nenhum app separado.

Estado Atual

O bot está em produção e funcionando. Os comandos disponíveis hoje são /gastar, /ganhar e /extrato, cobrindo o fluxo básico de controle financeiro. O registro acontece no momento da transação, que é quando o controle financeiro realmente funciona.

Infraestrutura

O Plin roda num notebook antigo reutilizado como servidor doméstico com CasaOS. O bot é containerizado com Docker, o que garante que qualquer atualização possa ser feita sem derrubar o serviço. O banco de dados é SQLite gerenciado via SQLAlchemy, priorizando portabilidade. Os dados financeiros ficam inteiramente sob controle próprio, sem depender de nenhum serviço externo.

Manter um serviço rodando continuamente em hardware próprio ensina coisas que nenhuma VPS ensina: gerenciamento de energia, rede local, reinicialização automática de containers e monitoramento básico.

Próximos Passos

A próxima versão vai substituir os comandos fixos por linguagem natural. Em vez de /gastar 40 pizza, o usuário vai poder escrever "gastei 40 reais com pizza hoje" e o bot vai entender. Depois disso, geração de gráficos de saúde financeira diretamente no chat.

Demonstração do Plin Bot em funcionamento.


Ver Código no GitHub Teste o Plin aqui!