Spendif.ai — Installatie & eerste start

✨Wat je krijgt

Importeert CSV/XLSX van elke bank — herkent het formaat automatisch, geen handmatige mapping
AI-categorisatie, volledig offline — lokaal LLM inbegrepen, geen cloud nodig
Lokale AI standaard — gegevens blijven op je machine; remote LLM is opt-in en redigeert IBAN / kaarten / rekeninghouder-namen (bedragen en datums reizen nog steeds — zie roadmap)
Vijf talen — Italiaans, Engels, Frans, Duits, Spaans
Kaart-rekening reconciliatie (bèta) — koppelt creditcard-afschrijvingen aan de onderliggende uitgaven om dubbeltelling te voorkomen(edge cases nog in verfijning)
Detectie van interne overboekingen (bèta) — matcht overboekingen tussen je eigen rekeningen zodat ze de dashboards niet opblazen(edge cases nog in verfijning)

1Download voor jouw systeem

De officiële installers worden gepubliceerd als assets van elke GitHub Release. Kies het juiste formaat voor je OS.

🍎

macOS

SpendifAi-*.dmg

DMG downloaden

macOS 12 Monterey of nieuwer. Apple Silicon + Intel.

🪟

Windows

SpendifAi-*.msix

MSIX downloaden

Windows 10 1809+ / Windows 11. Sideload + vertrouwd certificaat vereist in de pre-alpha-fase.

🐧

Debian / Ubuntu

spendifai_*_amd64.deb

.deb downloaden

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

🎩

Fedora / RHEL

spendifai-*.rpm

.rpm downloaden

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

Op zoek naar een specifieke versie? Bekijk alle releases · Broncode: drake69/spendif-ai.

2Installeren

macOS — DMG

1. Dubbelklik op het gedownloade .dmg-bestand.

2. Sleep Spendif.ai.app naar de map Programma's.

3. Eject de DMG (Cmd+E) en start de app vanuit Launchpad.

Als je "Kan Spendif.ai niet openen omdat de ontwikkelaar niet kan worden geverifieerd" ziet (build nog niet ondertekend): rechtermuisklik op de app → Open → bevestigen.

📷 Schermafbeelding

assets/screenshots/macos-dmg-dragdrop.png

(slepen & neerzetten van DMG naar Programma's)

Windows — MSIX

1. Dubbelklik op het gedownloade .msix-bestand.

2. De ingebouwde App Installer van Windows opent. Klik op Installeren.

3. De app verschijnt in het Startmenu — start hem daar vandaan.

Als je "Onbekende uitgever" ziet: open PowerShell als beheerder en importeer het certificaat eenmalig (zie de handleiding).

📷 Schermafbeelding

assets/screenshots/windows-msix-install.png

(Windows App Installer dialoog)

Linux — .deb / .rpm

Vanuit de terminal:

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

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

De postinst installeert uv, maakt het venv aan, downloadt het model en schrijft .env. Volledige handleiding: install guide.

📷 Schermafbeelding

assets/screenshots/linux-deb-install.png

(dpkg/dnf terminaloutput)

3Eerste start

Bij de eerste start zet Spendif.ai zijn omgeving op — dat is de langste stap, maar gebeurt slechts één keer.

⏱ Benodigde tijd: 5–15 minuten bij een typische thuisverbinding. Benodigde vrije ruimte: ~5 GB.
Houd het venster open tot de voortgangsbalk verdwijnt.

3a. Splash + AI-model download

Dubbelklikken opent een native venster met een splashscreen en voortgangsbalk. Spendif.ai detecteert beschikbaar RAM/VRAM en downloadt het meest geschikte LLM (Qwen 2.5, Gemma 3 — formaten van 2 tot 8 GB).

Het model staat in ~/.spendifai/models/ (macOS/Linux) of %APPDATA%\Spendif.ai\models\ (Windows) en blijft staan bij herinstallaties.

📷 Schermafbeelding

assets/screenshots/splash-download-progress.png

(splash + voortgang modeldownload)

3b. Onboarding-wizard — 4 stappen

Zodra het model klaar is, maakt het splash plaats voor de configuratiewizard:

1. Taal — taxonomie, datumnotatie, numerieke scheidingstekens.
2. Houders — je naam en de varianten die je bank gebruikt.
3. Rekeningen — betaalrekening, kaarten, contant geld.
4. Bevestigen — alles wordt alleen hier geschreven, geen gedeeltelijke persistentie.

Geen enkele keuze is definitief: je kunt alles later wijzigen via Instellingen.

📷 Schermafbeelding

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

(wizard stap 1 — taalkeuze)

3c. App klaar

Bij bevestiging maakt Spendif.ai de SQLite-database aan en brengt je naar de Import-pagina. Vanaf daar laad je je eerste bank-CSV/XLSX-bestanden.

Bij volgende keren is de flow: dubbelklik → splash (1-2 seconden) → app. Geen downloads meer, geen wizard meer.

📷 Schermafbeelding

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

(app klaar, Import-pagina)

Problemen?

Volledige documentatie: installatiehandleiding · gebruikershandleiding · macOS detail · Windows detail.

Bugs, vragen, verzoeken: open een issue op GitHub.