Spendif.ai — Installazione e primo avvio

✨Cosa ottieni

Importa CSV/XLSX di qualsiasi banca — riconosce il formato in automatico, nessun mapping manuale
Categorizzazione AI, completamente offline — LLM locale incluso, nessun cloud
AI locale di default — i dati restano sulla tua macchina; LLM remoto opt-in con redazione di IBAN / carte / nomi titolare (importi e date viaggiano comunque — roadmap aperta)
Cinque lingue — italiano, inglese, francese, tedesco, spagnolo
Riconciliazione carta-conto (beta) — appaia gli addebiti carta con le spese sottostanti per evitare il double-counting(edge cases ancora in raffinamento)
Rilevazione giroconti (beta) — matcha i giroconti tra i tuoi conti perché non gonfino i dashboard(edge cases ancora in raffinamento)

1Scarica per il tuo sistema

Gli installer ufficiali sono pubblicati come asset di ogni GitHub Release. Scegli il formato adatto al tuo OS.

🍎

macOS

SpendifAi-*.dmg

Scarica DMG

macOS 12 Monterey o superiore. Apple Silicon + Intel.

🪟

Windows

SpendifAi-*.msix

Scarica MSIX

Windows 10 1809+ / Windows 11. Sideload + cert trusted richiesti per la fase pre-alpha.

🐧

Debian / Ubuntu

spendifai_*_amd64.deb

Scarica .deb

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

🎩

Fedora / RHEL

spendifai-*.rpm

Scarica .rpm

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

Cerchi una versione specifica? Vedi tutte le release · Codice sorgente: drake69/spendif-ai.

2Installa

macOS — DMG

1. Doppio click sul file .dmg scaricato.

2. Trascina Spendif.ai.app nella cartella Applicazioni.

3. Espelli il DMG (Cmd+E) e lancia l'app dal Launchpad.

Se vedi l'avviso "Impossibile aprire perché lo sviluppatore non può essere verificato" (versione non ancora firmata): tasto destro sull'app → Apri → conferma.

📷 Screenshot

assets/screenshots/macos-dmg-dragdrop.png

(drag & drop dal DMG ad Applicazioni)

Windows — MSIX

1. Doppio click sul file .msix scaricato.

2. Si apre l'installer App Installer integrato in Windows. Premi Installa.

3. L'app appare nello Start Menu e si lancia da lì.

Se vedi "Editore sconosciuto": apri PowerShell come admin e importa una volta il certificato (vedi guida).

📷 Screenshot

assets/screenshots/windows-msix-install.png

(App Installer di Windows)

Linux — .deb / .rpm

Da terminale:

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

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

Il postinst installa uv, crea il venv, scarica il modello e configura .env. Vedi guida completa.

📷 Screenshot

assets/screenshots/linux-deb-install.png

(output terminale dpkg/dnf)

3Primo avvio

Al primo avvio Spendif.ai prepara l'ambiente — è il passaggio più lungo, ma succede solo la prima volta.

⏱ Tempo richiesto: dipende dalla velocità della tua connessione (di solito 5-15 minuti). Spazio libero richiesto: ~5 GB. Buona notizia: puoi iniziare a compilare il wizard subito, il modello si scarica in parallelo.

3a. Splash + download modello AI (in parallelo)

Al doppio click si apre una finestra nativa con uno splash screen. Spendif.ai rileva la RAM/VRAM disponibile e fa partire il download in background del modello LLM più adatto al tuo hardware (Qwen 2.5, Gemma 3, dimensioni da 1 a 8 GB).

Il modello finisce in ~/.spendifai/models/ (macOS/Linux) o %USERPROFILE%\.spendifai\models\ (Windows) e sopravvive a reinstallazioni. Il wizard di configurazione appare in pochi secondi, senza attendere la fine del download.

📷 Screenshot

assets/screenshots/splash-download-progress.png

(splash + barra progresso download modello)

3b. Wizard di onboarding — 4 step

Mentre il modello continua a scaricarsi in background, il wizard di configurazione ti guida in 4 step:

1. Lingua — tassonomia, formato date e separatori numerici.
2. Titolari — il tuo nome e le varianti usate dalla banca.
3. Conti — conto corrente, carte, contanti.
4. Riepilogo + Avvia — tutto viene scritto solo qui, nessuna persistenza parziale.

Su ogni step un banner mostra il progresso del download (es. "📚 78% · ~3 min"). Sul riepilogo finale il bottone Avvia resta disabilitato finché il modello non è al 100% — così quando entri nell'app Import è subito utilizzabile. Tutto è cambiabile da Impostazioni in seguito.

📷 Screenshot

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

(wizard step 1 — selezione lingua)

3c. App pronta

Al confirm del wizard, Spendif.ai crea il database SQLite e ti porta sulla pagina Import. Da qui carichi i primi CSV/XLSX della tua banca.

Dai successivi avvii il flusso è: doppio click → splash (1-2 secondi) → app. Niente più download, niente più wizard.

📷 Screenshot

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

(app pronta, pagina Import)

Hai problemi?

Documentazione completa: guida installazione · guida utente · macOS dettagliata · Windows dettagliata.

Bug, domande, richieste: apri una issue su GitHub.

Cosa arriva dopo

Spendif.ai è in alpha test. Le funzioni che aggiungeremo le decidiamo insieme a chi usa l'app oggi: nessun lavoro speculativo, nessuna roadmap calata dall'alto.

Funzioni in valutazione in base ai feedback degli alpha tester:

Tracking del cash — registrare manualmente le spese in contanti, senza estratto bancario
Performance degli investimenti — vedere a colpo d'occhio come stanno andando gli strumenti del portafoglio
App mobile compagna — registrare cash al volo dal telefono e sincronizzare col desktop

Una di queste ti servirebbe? Faccelo sapere su GitHub Discussions. Quando arrivano abbastanza richieste sulla stessa funzione, sale in cima alla coda.