Gastô

App Android de finanças pessoais com registro por voz e texto, classificação automática offline, score financeiro, metas, desafios, importação de CSV, widget nativo e educação financeira — tudo 100% local.

Como funciona

O usuário fala ou digita algo como "uber vinte reais". O app transcreve a fala via Google STT nativo do Android, extrai o valor e prediz a categoria usando um modelo TF-IDF + LinearSVC que roda localmente no celular, e salva no SQLite — sem servidor de dados, sem cadastro.

Funcionalidades

	Funcionalidade
🎙️	Registro por voz em linguagem natural (Google STT)
⌨️	Registro por texto — mesmo resultado
🤖	Classificação offline (TF-IDF + LinearSVC em TypeScript)
💰	Entradas e despesas separadas, ambas editáveis
🔄	Despesas e entradas recorrentes automáticas com status pago/pendente
🎯	Orçamento por categoria com alerta em 80% e ao estourar
📈	Meta de economia mensal
📊	Relatórios com gráfico de distribuição e gastos por dia
🗓️	Histórico de qualquer mês
📤	Exportar CSV
🔍	Busca por descrição ou categoria
📅	Visão do próximo mês (recorrentes agendados)
🔮	Simulador de investimentos com CDI ao vivo (BCB)
📰	Notícias de finanças/economia (RSS G1 + InfoMoney)
📉	Indicadores de mercado ao vivo: Dólar, Euro, CDI, Selic, IPCA
🎓	Educação financeira — pílulas por nível e objetivo
🌙	Tema claro, escuro ou automático pelo sistema
⚙️	Configurações de nome e moeda
🔒	100% local — SQLite no dispositivo, sem cadastro
🏅	Score financeiro mensal (0–100): poupança, orçamentos e meta
💡	Análise de padrões automática: crescimento por categoria, fins de semana, tendência 3 meses
🏆	Metas por objetivo com prazo, progresso e aporte mensal calculado
🔢	Calculadora de independência financeira (regra dos 4%) com projeção de anos
📉	Comparativo com inflação real: cada categoria vs IPCA do período (API BCB)
💪	Modo desafio semanal: metas de redução geradas a partir dos seus próprios gastos
📂	Importar extrato CSV de qualquer banco com classificação automática offline
📱	Widget Android — saldo do mês na tela inicial, atualiza a cada 30 min

Estrutura do repositório

gasto/
├── app/                              # React Native (Expo SDK 54)
│   ├── app/
│   │   ├── (tabs)/
│   │   │   ├── index.tsx             # Aba Despesas (busca, recorrentes)
│   │   │   ├── income.tsx            # Aba Entradas (editar, swipe)
│   │   │   ├── reports.tsx           # Aba Relatórios + botão simulador
│   │   │   ├── news.tsx              # Aba Mercado (RSS + indicadores BCB)
│   │   │   ├── learn.tsx             # Aba Aprender (educação financeira)
│   │   │   └── settings.tsx          # Aba Configurações (tema, nome, moeda)
│   │   ├── confirm.tsx               # Confirmação/edição antes de salvar
│   │   ├── edit.tsx                  # Edição de despesa existente
│   │   ├── edit-entrada.tsx          # Edição de entrada existente
│   │   ├── add-entrada.tsx           # Nova entrada de receita
│   │   ├── budget.tsx                # Orçamentos por categoria
│   │   ├── next-month.tsx            # Visão do próximo mês (recorrentes)
│   │   ├── simulator.tsx             # Simulador de investimentos + calculadora IF
│   │   ├── pill.tsx                  # Leitura de pílula educacional
│   │   ├── goals.tsx                 # Metas por objetivo (prazo, progresso, aporte)
│   │   ├── challenge.tsx             # Modo desafio semanal por categoria
│   │   ├── import-csv.tsx            # Importar extrato CSV de banco
│   │   └── termos.tsx                # Termos de uso / privacidade
│   ├── components/
│   │   └── ExpenseItem.tsx           # Card com swipe deletar/editar + status pago
│   ├── lib/
│   │   ├── db.ts                     # Camada SQLite (expo-sqlite)
│   │   ├── api.ts                    # parseTexto
│   │   ├── classifier.ts             # Inferência TF-IDF + LinearSVC offline
│   │   ├── theme.ts                  # Tokens de cor claro/escuro
│   │   ├── types.ts                  # Tipos TypeScript compartilhados
│   │   ├── AppConfigContext.tsx      # Contexto global (tema, nome, moeda, fmt)
│   │   ├── bcb.ts                    # Indicadores BCB ao vivo (Dólar, CDI, Selic…)
│   │   ├── rss.ts                    # Parser RSS puro TS (G1, InfoMoney)
│   │   └── courses.ts                # Fetch e cache de cursos (GitHub Pages)
│   ├── constants/
│   │   ├── categories.ts             # 9 categorias de despesa
│   │   └── incomeCategories.ts       # 6 categorias de entrada
│   └── assets/
│       └── model.json                # Modelo exportado pelo export_model.py
│
├── android/                          # Módulos nativos Android
│   └── app/src/main/
│       ├── java/com/anonymous/gasto/
│       │   └── SaldoWidget.kt        # AppWidgetProvider — lê SQLite e exibe saldo
│       └── res/
│           ├── layout/widget_saldo.xml   # Layout do widget
│           └── xml/widget_info.xml       # Metadados (tamanho, intervalo de atualização)
│
├── model/                            # Pipeline de treinamento do classificador
│   ├── generate_dataset.py           # Gera dataset sintético em português
│   ├── train.py                      # Treina TF-IDF + LinearSVC
│   ├── export_model.py               # Exporta modelo para app/assets/model.json
│   └── data/
│       └── dataset.csv               # Dataset de treino (versionado)
│
└── docs/                             # Site GitHub Pages
    ├── index.html
    ├── styles.css
    ├── courses.json                  # Conteúdo de educação financeira (30 pílulas, 5 trilhas)
    └── screenshots/

Stack

Camada	Tecnologia	Notas
App	React Native 0.81 + Expo SDK 54	TypeScript, bare workflow
Navegação	Expo Router 6 (file-based)	6 abas + modais
Banco de dados	SQLite via `expo-sqlite`	Local, sem sincronização
Classificador	TF-IDF + LinearSVC	sklearn → JSON → TS, roda no device
Transcrição de voz	Google STT nativo (`expo-speech-recognition`)	Requer internet; usa o reconhecedor embutido no Android
Gráficos	`react-native-svg`
Animações	`react-native-reanimated` 4.x	Requer New Architecture
Indicadores financeiros	API BCB/SGS	Dólar, Euro, CDI, Selic, IPCA — sem chave
Notícias	RSS puro TS	G1 Economia + InfoMoney, parser sem dependências
Educação	JSON em GitHub Pages	`courses.json` com 5 trilhas e 30 pílulas
Importação de CSV	`expo-document-picker` + parser TS	Auto-detecta separador, colunas e datas
Widget Android	`AppWidgetProvider` Kotlin nativo	Lê SQLite diretamente, atualiza a cada 30 min

Setup local

Pré-requisitos

Node.js 18+
Android Studio com SDK 34+ (ou dispositivo físico)
Python 3.11+ (somente para re-treino do modelo)

1. App

cd app
npm install
npx expo start

O app usa newArchEnabled: true (New Architecture). Requer dispositivo físico ou emulador Android com Google STT disponível para o recurso de voz.

2. Gerar APK de release

cd app
npx expo prebuild --platform android --clean
echo "sdk.dir=$HOME/Android/Sdk" > android/local.properties   # ajuste o caminho
cd android && ./gradlew assembleRelease

APK gerado em android/app/build/outputs/apk/release/app-release.apk.

3. Re-treinar o classificador (opcional)

cd model
pip install -r requirements.txt

python generate_dataset.py   # regenera dataset sintético
python train.py              # treina TF-IDF + LinearSVC
python export_model.py       # grava app/assets/model.json

O modelo é um arquivo JSON com vocabulário, pesos IDF e coeficientes do SVC — sem dependência de runtime Python no app.

Arquitetura

fala do usuário
     │
     ▼ (expo-speech-recognition)
Google STT  ─── requer internet
     │
     ▼
texto transcrito
     │
     ▼
normalização (lowercase, remove pontuação, stopwords PT)
     │
     ▼
TF-IDF vectorizer  ←── vocabulário do model.json
     │
     ▼
LinearSVC predict  ←── coeficientes do model.json  ← 100% offline
     │
     ▼
categoria + top-3 sugestões + extração de valor

O modo texto (digitado) bypassa o Google STT e vai direto para a normalização — 100% offline.

Para adicionar categorias ou melhorar a acurácia: edite o dataset em model/data/dataset.csv, re-treine e exporte.

Como contribuir

Contribuições são bem-vindas. Algumas áreas abertas:

Voz offline — atualmente usa Google STT (requer internet); contribuições para transcrição 100% offline são bem-vindas (ex: vosk-react-native, sherpa-onnx)
Testes automatizados — o projeto não tem testes; testes unitários para classifier.ts e db.ts seriam um bom começo
iOS — o app foi desenvolvido e testado apenas em Android; a estrutura Expo suporta iOS mas não foi validado
Sincronização opcional — exportação para nuvem (iCloud / Google Drive) sem comprometer o modelo local-first
Melhorias no dataset — mais exemplos no dataset.csv melhoram diretamente a acurácia da classificação
Pílulas educacionais — contribuições de conteúdo para docs/courses.json são bem-vindas

Fluxo

# 1. Fork + clone
git clone https://github.com/SEU_USUARIO/gasto.git

# 2. Crie uma branch
git checkout -b feat/minha-contribuicao

# 3. Faça as alterações e commit
git commit -m "feat: descrição clara do que foi feito"

# 4. Abra um Pull Request para main

Links

Site: https://jeffev.github.io/gasto/
Download APK: https://github.com/jeffev/gasto/releases/latest/download/gasto.apk
Issues / sugestões: https://github.com/jeffev/gasto/issues

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
app		app
backend		backend
docs		docs
model		model
.gitignore		.gitignore
Logo.png		Logo.png
MELHORIAS.md		MELHORIAS.md
README.md		README.md

Navigation Menu

Repository navigation

About

Repository files navigation

Gastô

Como funciona

Funcionalidades

Estrutura do repositório

Stack

Setup local

Pré-requisitos

1. App

2. Gerar APK de release

3. Re-treinar o classificador (opcional)

Arquitetura

Como contribuir

Fluxo

Links

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

Gastô

Como funciona

Funcionalidades

Estrutura do repositório

Stack

Setup local

Pré-requisitos

1. App

2. Gerar APK de release

3. Re-treinar o classificador (opcional)

Arquitetura

Como contribuir

Fluxo

Links

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages