Installatie & eerste start

Drie stappen om Spendif.ai op je computer te laten draaien: downloaden, installeren, eerste start. Alles offline, geen account nodig.

✨Wat je krijgt

1Download voor jouw systeem

🍎

macOS

SpendifAi-*.dmg
DMG downloaden
macOS 12 Monterey of nieuwer. Alleen Apple Silicon (M1 of nieuwer).
πŸͺŸ

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

Of gebruik Homebrew:

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

Daarna werk je bij met brew update && brew upgrade --cask spendifai.

πŸ“· 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.