Installazione e primo avvio

Tre passi per avere Spendif.ai in funzione sul tuo computer: scarica, installa, primo avvio. Tutto offline, niente account.

Cosa ottieni

1Scarica per il tuo sistema

🍎

macOS

SpendifAi-*.dmg
Scarica DMG
macOS 12 Monterey o superiore. Solo Apple Silicon (M1 o successivi).
Hai un Mac Intel? Scrivicelo: la build Intel non è prevista, ma basta una richiesta per ripensarci.
🪟

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: spendifai/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.

Il DMG è firmato con certificato Developer ID e notarizzato da Apple: macOS lo apre senza avvisi.

In alternativa, con Homebrew:

brew tap spendifai/spendifai
brew trust --cask spendifai/spendifai/spendifai
brew install --cask spendifai

Da qui in avanti aggiorni con brew update && brew upgrade --cask spendifai.

📷 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ì.

Le prime volte Windows può mostrare "Windows ha protetto il PC": clicca su "Ulteriori informazioni" e poi su "Esegui comunque". L'avviso sparisce man mano che il certificato accumula reputazione. Dettagli nella 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 solo uv. Al primo avvio l'app crea il venv, scarica il modello e configura .env: la prima apertura richiede quindi qualche minuto. 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)

Disinstallare

Niente resta sul computer contro la tua volontà. Il comando dipende da come hai installato:

Non ricordi come hai installato? Se hai usato il Terminale è Homebrew, altrimenti è il DMG.

macOS, Homebrew: brew uninstall --cask spendifai

macOS, DMG: trascina Spendif.ai.app nel Cestino

Debian / Ubuntu: sudo apt remove spendifai

Fedora / RHEL: sudo dnf remove spendifai

Windows: Impostazioni > App > Spendif.ai > Disinstalla

I tuoi dati restano, ed è voluto. In ~/.spendifai (su Windows %USERPROFILE%\.spendifai) ci sono il database delle transazioni, le impostazioni e i modelli AI, diversi GB in tutto. Nessuno dei comandi qui sopra li tocca.

Prima di cancellarli, esporta quello che vuoi tenere dalla pagina Registro: una volta rimossi non si recuperano.

Per rimuovere anche i dati: con Homebrew brew uninstall --zap --cask spendifai. Altrimenti usa il disinstallatore del tuo sistema (macOS, Linux, Windows), che chiede conferma separatamente per il database e per i modelli, oppure cancella a mano la cartella.

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:

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