Installation et premier lancement

Trois étapes pour faire fonctionner Spendif.ai sur votre ordinateur : télécharger, installer, premier lancement. Tout en local, sans compte.

Ce que vous obtenez

1Téléchargez pour votre système

🍎

macOS

SpendifAi-*.dmg
Télécharger DMG
macOS 12 Monterey ou supérieur. Apple Silicon uniquement (M1 ou plus récent).
Vous avez un Mac Intel ? Dites-le-nous: une version Intel n'est pas prévue, mais une seule demande suffit à y revenir.
🪟

Windows

SpendifAi-*.msix
Télécharger MSIX
Windows 10 1809+ / Windows 11. Sideload + certificat de confiance requis pendant la pré-alpha.
🐧

Debian / Ubuntu

spendifai_*_amd64.deb
Télécharger .deb
Ubuntu 22.04+, Debian 12+, Mint 21+.
🎩

Fedora / RHEL

spendifai-*.rpm
Télécharger .rpm
Fedora 40+, RHEL 9+, Rocky / Alma 9+.

Vous cherchez une version spécifique ? Voir toutes les releases · Code source : spendifai/spendif-ai.

2Installer

macOS: DMG

1. Double-cliquez sur le fichier .dmg téléchargé.

2. Glissez Spendif.ai.app dans le dossier Applications.

3. Éjectez le DMG (Cmd+E) et lancez l'app depuis Launchpad.

Le DMG est signé avec un certificat Developer ID et notarisé par Apple : macOS l'ouvre sans avertissement.

Ou bien, avec Homebrew :

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

Ensuite, vous mettez à jour avec brew update && brew upgrade --cask spendifai.

📷 Capture
assets/screenshots/macos-dmg-dragdrop.png
(glisser-déposer du DMG vers Applications)

Windows: MSIX

1. Double-cliquez sur le fichier .msix téléchargé.

2. L'installeur d'applications intégré à Windows s'ouvre. Cliquez sur Installer.

3. L'app apparaît dans le menu Démarrer: lancez-la depuis là.

Les premières fois, Windows peut afficher "Windows a protégé votre ordinateur" : cliquez sur "Informations complémentaires" puis sur "Exécuter quand même". L'avertissement disparaît à mesure que le certificat acquiert de la réputation. Détails dans le guide.

📷 Capture
assets/screenshots/windows-msix-install.png
(boîte de dialogue Windows App Installer)

Linux: .deb / .rpm

Depuis le terminal :

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

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

Le postinst installe uniquement uv. Le venv, le téléchargement du modèle et .env se font au premier lancement, qui prend donc quelques minutes. Guide complet.

📷 Capture
assets/screenshots/linux-deb-install.png
(sortie terminal dpkg/dnf)

3Premier lancement

Au premier lancement, Spendif.ai prépare son environnement: c'est l'étape la plus longue, mais elle n'arrive qu'une fois.

⏱ Temps requis : 5-15 minutes sur une connexion domestique typique. Espace libre requis : ~5 Go.
Gardez la fenêtre ouverte jusqu'à ce que la barre de progression disparaisse.

3a. Splash + téléchargement du modèle IA

Double-cliquer ouvre une fenêtre native avec un écran de démarrage et une barre de progression. Spendif.ai détecte la RAM/VRAM disponible et télécharge le LLM le plus adapté (Qwen 2.5, Gemma 3: tailles de 2 à 8 Go).

Le modèle est stocké dans ~/.spendifai/models/ (macOS/Linux) ou %APPDATA%\Spendif.ai\models\ (Windows) et survit aux réinstallations.

📷 Capture
assets/screenshots/splash-download-progress.png
(splash + progression téléchargement modèle)

3b. Assistant d'onboarding: 4 étapes

Une fois le modèle prêt, le splash laisse place à l'assistant de configuration :

1. Langue: taxonomie, format de date, séparateurs numériques.
2. Titulaires: votre nom et les variantes utilisées par la banque.
3. Comptes: compte courant, cartes, espèces.
4. Confirmer: tout est écrit ici uniquement, pas de persistance partielle.

Aucun choix n'est définitif : tout peut être modifié plus tard depuis Paramètres.

📷 Capture
assets/screenshots/onboarding-step-1-language.png
(assistant étape 1: choix de la langue)

3c. App prête

À la confirmation, Spendif.ai crée la base SQLite et vous emmène sur la page Importer. Depuis là, vous chargez vos premiers CSV/XLSX bancaires.

Aux lancements suivants : double-clic → splash (1-2 secondes) → app. Plus de téléchargements, plus d'assistant.

📷 Capture
assets/screenshots/app-ready-import-page.png
(app prête, page Importer)

Désinstaller

Rien ne reste sur votre ordinateur contre votre volonté. La commande dépend de la façon dont vous avez installé :

Vous ne savez plus comment vous avez installé ? Si vous avez utilisé le Terminal, c'était Homebrew, sinon c'était le DMG.

macOS, Homebrew: brew uninstall --cask spendifai

macOS, DMG: glissez Spendif.ai.app dans la Corbeille

Debian / Ubuntu: sudo apt remove spendifai

Fedora / RHEL: sudo dnf remove spendifai

Windows: Paramètres > Applications > Spendif.ai > Désinstaller

Vos données restent, et c'est voulu. ~/.spendifai (sous Windows %USERPROFILE%\.spendifai) contient votre base de données de transactions, vos réglages et les modèles d'IA, plusieurs Go au total. Aucune des commandes ci-dessus n'y touche.

Exportez ce que vous voulez garder avant de le supprimer, depuis la page Registre : une fois supprimé, rien n'est récupérable.

Pour supprimer aussi les données : avec Homebrew, brew uninstall --zap --cask spendifai. Sinon, utilisez le désinstalleur de votre système (macOS, Linux, Windows), qui demande séparément pour la base de données et pour les modèles, ou supprimez le dossier vous-même.

Des problèmes ?

Documentation complète : guide d'installation · guide utilisateur · macOS détaillé · Windows détaillé.

Bugs, questions, demandes : ouvrir une issue sur GitHub.

Ce qui arrive ensuite

Spendif.ai est en alpha. Les fonctionnalités que nous ajouterons seront décidées avec les personnes qui utilisent l'app aujourd'hui : pas de travail spéculatif, pas de roadmap imposée d'en haut.

Fonctionnalités à l'étude selon les retours des alpha testeurs :

L'une de ces options vous serait-elle utile ? Dites-le-nous sur GitHub Discussions. Quand suffisamment de demandes s'accumulent sur la même fonctionnalité, elle monte en tête de file.