Spendif.ai — Instalação e primeira execução

✨O que você obtém

Importa CSV/XLSX de qualquer banco — detecta o formato automaticamente, sem mapeamento manual
Categorização por IA, totalmente offline — LLM local incluído, sem nuvem
IA local por padrão — os dados permanecem na sua máquina; o LLM remoto é opt-in e redige IBAN / cartões / nomes do titular (os valores e datas ainda viajam — ver roadmap)
Cinco idiomas — italiano, inglês, francês, alemão, espanhol
Reconciliação cartão-conta (beta) — pareia os débitos do cartão com os gastos subjacentes para evitar dupla contagem(casos extremos ainda em refinamento)
Detecção de transferências internas (beta) — relaciona as transferências entre as suas contas para que não inflacionem os dashboards(casos extremos ainda em refinamento)

1Baixe para o seu sistema

Os instaladores oficiais são publicados como assets de cada GitHub Release. Escolha o formato adequado para o seu SO.

🍎

macOS

SpendifAi-*.dmg

Baixar DMG

macOS 12 Monterey ou superior. Apple Silicon + Intel.

🪟

Windows

SpendifAi-*.msix

Baixar MSIX

Windows 10 1809+ / Windows 11. Sideload + certificado confiável necessários na fase pre-alpha.

🐧

Debian / Ubuntu

spendifai_*_amd64.deb

Baixar .deb

Ubuntu 22.04+, Debian 12+, Mint 21+.

🎩

Fedora / RHEL

spendifai-*.rpm

Baixar .rpm

Fedora 40+, RHEL 9+, Rocky / Alma 9+.

Procurando uma versão específica? Veja todas as releases · Código-fonte: drake69/spendif-ai.

2Instalar

macOS — DMG

1. Dê duplo clique no arquivo .dmg baixado.

2. Arraste Spendif.ai.app para a pasta Aplicativos.

3. Ejete o DMG (Cmd+E) e inicie o app pelo Launchpad.

Se você vir "Não é possível abrir o Spendif.ai porque o desenvolvedor não pode ser verificado" (build ainda não assinada): clique com o botão direito no app → Abrir → confirmar.

📷 Captura

assets/screenshots/macos-dmg-dragdrop.png

(arrastar e soltar do DMG para Aplicativos)

Windows — MSIX

1. Dê duplo clique no arquivo .msix baixado.

2. O Instalador de Aplicativos integrado do Windows abre. Clique em Instalar.

3. O app aparece no Menu Iniciar — abra a partir dali.

Se você vir "Editor desconhecido": abra o PowerShell como administrador e importe o certificado uma vez (veja o guia).

📷 Captura

assets/screenshots/windows-msix-install.png

(diálogo do Instalador de Aplicativos do Windows)

Linux — .deb / .rpm

No terminal:

sudo apt install ./spendifai_*.deb (Debian/Ubuntu)

sudo dnf install ./spendifai-*.rpm (Fedora/RHEL)

O postinst instala o uv, cria o venv, baixa o modelo e configura o .env. Guia completo: documentação de instalação.

📷 Captura

assets/screenshots/linux-deb-install.png

(saída do terminal dpkg/dnf)

3Primeira execução

Na primeira execução, o Spendif.ai prepara o ambiente — é o passo mais longo, mas acontece apenas uma vez.

⏱ Tempo necessário: 5–15 minutos numa conexão doméstica típica. Espaço livre necessário: ~5 GB.
Mantenha a janela aberta até a barra de progresso desaparecer.

3a. Splash + download do modelo de IA

Ao dar duplo clique, abre-se uma janela nativa com uma tela de abertura e barra de progresso. O Spendif.ai detecta a RAM/VRAM disponível e baixa o LLM mais adequado (Qwen 2.5, Gemma 3 — tamanhos de 2 a 8 GB).

O modelo fica em ~/.spendifai/models/ (macOS/Linux) ou %APPDATA%\Spendif.ai\models\ (Windows) e sobrevive a reinstalações.

📷 Captura

assets/screenshots/splash-download-progress.png

(splash + progresso do download do modelo)

3b. Assistente de onboarding — 4 passos

Quando o modelo estiver pronto, a splash dá lugar ao assistente de configuração:

1. Idioma — taxonomia, formato de data, separadores numéricos.
2. Titulares — seu nome e as variantes usadas pelo banco.
3. Contas — conta corrente, cartões, dinheiro.
4. Confirmar — tudo é gravado apenas aqui, sem persistência parcial.

Nenhuma escolha é definitiva: você pode alterar tudo depois em Configurações.

📷 Captura

assets/screenshots/onboarding-step-1-language.png

(assistente passo 1 — seleção de idioma)

3c. App pronto

Ao confirmar, o Spendif.ai cria o banco de dados SQLite e leva você para a página Importar. A partir daí, você carrega os primeiros arquivos CSV/XLSX do seu banco.

Nas execuções seguintes o fluxo é: duplo clique → splash (1-2 segundos) → app. Sem mais downloads, sem mais assistente.

📷 Captura

assets/screenshots/app-ready-import-page.png

(app pronto, página Importar)

Com problemas?

Documentação completa: guia de instalação · guia do usuário · macOS detalhado · Windows detalhado.

Bugs, dúvidas, pedidos: abra uma issue no GitHub.