Três passos para deixar o Spendif.ai rodando no seu computador: baixar, instalar, primeira execução. Tudo offline, sem conta.
Procurando uma versão específica? Veja todas as releases · Código-fonte: spendifai/spendif-ai.
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.
O DMG é assinado com um certificado Developer ID e notarizado pela Apple: o macOS abre-o sem avisos.
Em alternativa, com Homebrew:
brew tap spendifai/spendifai
brew trust --cask spendifai/spendifai/spendifai
brew install --cask spendifai
A partir daí atualizas com brew update && brew upgrade --cask spendifai.
assets/screenshots/macos-dmg-dragdrop.png1. 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.
Nas primeiras vezes, o Windows pode mostrar "O Windows protegeu o seu PC": clique em "Mais informações" e depois em "Executar mesmo assim". O aviso desaparece à medida que o certificado ganha reputação. Detalhes no guia.
assets/screenshots/windows-msix-install.pngNo terminal:
sudo apt install ./spendifai_*.deb (Debian/Ubuntu)
sudo dnf install ./spendifai-*.rpm (Fedora/RHEL)
O postinst instala apenas uv. O venv, o download do modelo e o .env acontecem no primeiro arranque, que por isso demora alguns minutos. Guia completo.
assets/screenshots/linux-deb-install.pngNa primeira execução, o Spendif.ai prepara o ambiente: é o passo mais longo, mas acontece apenas uma vez.
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.
assets/screenshots/splash-download-progress.pngQuando 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.
assets/screenshots/onboarding-step-1-language.pngAo 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.
assets/screenshots/app-ready-import-page.pngNada fica no computador contra a sua vontade. O comando depende de como instalou:
Não se lembra de como instalou? Se usou o Terminal foi o Homebrew, caso contrário foi o DMG.
macOS, Homebrew: brew uninstall --cask spendifai
macOS, DMG: arraste Spendif.ai.app para o Lixo
Debian / Ubuntu: sudo apt remove spendifai
Fedora / RHEL: sudo dnf remove spendifai
Windows: Definições > Aplicações > Spendif.ai > Desinstalar
Os seus dados ficam, e é intencional. Em ~/.spendifai (no Windows %USERPROFILE%\.spendifai) estão a base de dados de transações, as suas definições e os modelos de IA, vários GB no total. Nenhum dos comandos acima lhes toca.
Exporte o que quiser manter antes de apagar, a partir da página Ledger: depois de removido não se recupera.
Para apagar também os dados: com Homebrew, brew uninstall --zap --cask spendifai. Caso contrário use o desinstalador do seu sistema (macOS, Linux, Windows), que pergunta separadamente pela base de dados e pelos modelos, ou apague a pasta manualmente.
Documentação completa: guia de instalação · guia do usuário · macOS detalhado · Windows detalhado.
Bugs, dúvidas, pedidos: abra uma issue no GitHub.