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).
Heb je een Intel-Mac? Laat het ons weten: een Intel-build staat niet gepland, maar één verzoek is genoeg om dat te heroverwegen.
🪟

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.

De DMG is ondertekend met een Developer ID-certificaat en genotariseerd door Apple: macOS opent hem zonder waarschuwingen.

Of gebruik Homebrew:

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

De eerste keren kan Windows "Windows heeft uw pc beveiligd" tonen: klik op "Meer informatie" en daarna op "Toch uitvoeren". De waarschuwing verdwijnt zodra het certificaat reputatie opbouwt. Details in 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 alleen uv. De venv, het downloaden van het model en .env gebeuren bij de eerste start, die daardoor enkele minuten duurt. Volledige handleiding.

📷 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)

Verwijderen

Er blijft niets tegen uw wil op de computer achter. Het commando hangt af van hoe u hebt geïnstalleerd:

Weet u niet meer hoe u hebt geïnstalleerd? Als u de Terminal gebruikte was het Homebrew, anders was het de DMG.

macOS, Homebrew: brew uninstall --cask spendifai

macOS, DMG: sleep Spendif.ai.app naar de Prullenmand

Debian / Ubuntu: sudo apt remove spendifai

Fedora / RHEL: sudo dnf remove spendifai

Windows: Instellingen > Apps > Spendif.ai > Verwijderen

Uw gegevens blijven staan, met opzet. In ~/.spendifai (op Windows %USERPROFILE%\.spendifai) staan uw transactiedatabase, uw instellingen en de AI-modellen, samen meerdere GB. Geen van bovenstaande commando's raakt ze aan.

Exporteer wat u wilt bewaren voordat u het verwijdert, via de pagina Ledger: eenmaal verwijderd is het niet terug te halen.

Om ook de gegevens te verwijderen: met Homebrew brew uninstall --zap --cask spendifai. Gebruik anders de uninstaller voor uw systeem (macOS, Linux, Windows), die apart vraagt naar de database en naar de modellen, of verwijder de map zelf.

Problemen?

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

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