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).
🪟

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.

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

In alternativa, con Homebrew:

brew tap spendifai/spendifai
brew trust --cask spendifai/spendifai/spendifai
brew install --cask --no-quarantine 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ì.

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:

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