Sos Financeiro

Meu Financeiro

Assessor financeiro pessoal que roda **local**, sobre os seus próprios documentos. Você joga extratos, faturas, holerites e relatórios de investimento numa pasta; a ferramenta normaliza, concilia, classifica e monta um painel. Nada sai da máquina.

Funciona como skill do Claude Code e como projeto no Codex ou Antigravity (via `AGENTS.md`). Somente pessoa física.

O que você precisa

Python 3.9+	Só isso para OFX, CSV, conciliação, classificação, análise e painel. Nenhuma dependência.
Um agente (Claude Code, Codex, Antigravity)	Para ler PDF sem parser, decidir categoria ambígua, conduzir a entrevista e conversar sobre os números.
pdftotext (poppler) — opcional	Ativa os parsers determinísticos de PDF. brew install poppler ou apt install poppler-utils.
pymupdf — opcional	Ativa o parser do Extrato de Movimentação da B3. pip install pymupdf.

Sem os dois opcionais nada quebra: o PDF é marcado como pendente e o agente lê. Com eles, a leitura é determinística, mais rápida e mais barata.

Começando

python3 scripts/init_base.py      # cria as pastas e a base
# coloque seus arquivos em entrada/
python3 scripts/importar.py       # OFX, CSV e PDFs de layout conhecido
python3 scripts/conciliar.py      # transferências próprias e pagamento de fatura
python3 scripts/classificar.py    # plano de contas
python3 scripts/analisar.py       # indicadores
python3 scripts/painel.py         # gera painel/index.html

Para ver o pipeline rodando sem usar dado real, veja [exemplo/LEIA-ME.md](exemplo/LEIA-ME.md).

Quanto disso já funciona para você

Sejamos francos sobre a cobertura, porque ela é desigual:

**Funciona para qualquer banco:** OFX e QFX (praticamente todo banco brasileiro exporta — Itaú, Bradesco, BB, Santander, Nubank, Inter, C6, cooperativas). CSV de banco e corretora, com detecção automática de separador, formato de data e vírgula decimal. **Se você tem OFX, está atendido** — e