OmniBank Local 🏦

Français • English

🇫🇷

OmniBank Local est une solution de gestion de finances personnelles et associatives ultra-privée, conçue pour ceux qui exigent un contrôle total sur vos données. Alliant la puissance d'un tableur à l'intelligence d'une IA locale, elle transforme votre gestion financière en une expérience fluide et sécurisée.

[!CAUTION] Avertissement : La sécurité du code n'a pas fait l'objet d'un audit indépendant. Utilisez cette application à vos propres risques et uniquement dans un environnement local sécurisé.

[!TIP] Chiffrement du disque recommandé : La base de données SQLite stocke vos données financières en clair sur le disque. Pour une protection optimale, activez le chiffrement intégral de votre disque (BitLocker sous Windows, LUKS sous Linux, FileVault sous macOS).

🌟 Pourquoi OmniBank ?

• 0 Cloud, 100% Offline : Vos données restent physiquement sur votre machine. Aucune télémétrie, aucun tracking.
• IA Locale & RAG : Vos transactions sont vectorisées en local pour permettre un dialogue fluide avec votre historique financier via Ollama.
• Contrôle Total des Catégories : Règles automatiques, détection intelligente de patterns et classification assistée.
• Visualisations Riches : Graphiques financiers clairs (Chart.js) et tableau virtuel pour les historiques volumineux.
• Conçu pour Durer : Base SQLite standard et exports universels (CSV, JSON).

✨ Fonctionnalités Clés

🏗️ Configuration Simplifiée (Setup Wizard)

Dès le premier lancement, un Assistant d'Initialisation vous guide pour configurer vos comptes, vos préférences et connecter votre instance Ollama.

📈 Analytique & Gestion Quotidienne

• Tableau de Bord Dynamique : Une vue d'ensemble de vos soldes, de vos budgets et de vos prochaines échéances.
• Historique Virtualisé : Gérez des milliers de transactions avec une fluidité parfaite grâce au rendu ultra-rapide.
• Rapprochement Intelligent : Un système visuel pour pointer vos opérations. Comparez d'un coup d'œil vos relevés bancaires (avant) et votre comptabilité propre (après).

Saisie d'opération	Historique	Rapprochement

🎯 Budget & Enveloppes

Suivez vos dépenses par catégories ou par projets avec un système d'enveloppes visuel. L'IA peut même vous suggérer des budgets basés sur vos habitudes.

Vue Budget	Détail Budget	Suggestions IA

🤖 Intelligence Artificielle Locale

Interagissez avec votre assistant financier personnel via Ollama. Grâce au RAG (Retrieval-Augmented Generation), l'IA accède à vos données pour répondre précisément. Elle peut même vous soumettre des propositions d'actions interactives directement dans le chat.

📊 Synthèse & Tendances

Visualisez l'évolution de votre patrimoine et générez des rapports PDF haute fidélité, parfaits pour un suivi comptable rigoureux ou un partage sécurisé.

Synthèse	Tendances	Export PDF

🛠️ Administration & Personnalisation

Prenez le contrôle total de votre structure financière grâce à des outils de gestion flexibles.

Comptes	Catégories	Récurrences	Configuration

🏢 Mode Organisation (Associations / CSE)

OmniBank propose un mode organisation conçu pour les associations, comités d'entreprise (CSE) et petites structures ayant besoin d'un suivi multi-utilisateur.

• 👥 Multi-utilisateur sans mot de passe : Chaque membre (trésorier, adjoint, secrétaire…) sélectionne son profil au lancement.
• 📋 Audit intégré : Chaque opération enregistre automatiquement qui l'a créée et qui l'a modifiée en dernier.
• 🔑 Licence requise : L'activation du mode organisation nécessite une clé de licence.

Pour obtenir une licence, ouvrez une Issue sur GitHub.

🚀 Installation

🖥️ Windows (Recommandé)

Téléchargez le dernier installateur .msi depuis la page des Releases.

🐳 Docker

docker-compose up -d --build

Accédez à l'interface sur http://localhost:8434.

🛠 Stack Technique

• Backend : Python (FastAPI), SQLAlchemy, Pandas.
• Frontend : HTML5/CSS3 (Vanilla), JavaScript, Chart.js.
• Desktop : Tauri (Wrapper Rust).
• IA : Ollama (Support Texte & Vision).

🆕 Nouveautés (v1.1.8)

• ⚡ Relevé Bancaire 2× Plus Rapide (Crédit Agricole) : La récupération des opérations en ligne est désormais jusqu'à deux fois plus rapide grâce à la réutilisation des sessions authentifiées et l'arrêt intelligent de la pagination.
• 🔐 Fiabilité du Flux Coffre & Synchronisation : Le clic sur « Relevé en ligne » fonctionne désormais correctement dans tous les cas — déverrouillage du coffre, ré-autorisation inter-navigateur et forçage de synchronisation.

📦 Historique Récent (v1.1.7)

• 📱 Forçage Manuel & Modale 2FA Directe : Synchronisation forcée instantanée, modale 2FA interactive automatique et persistance des sessions SCA 90 jours.
• 🛡️ Résilience Desktop & Double Smoke Test : Tests de fumée automatisés du sidecar et du MSI avant publication, écran de repli en cas d'anomalie.

📦 Historique Récent (v1.1.6)

• 🏛️ Migrations SQLite Modulaires : 24 modules versionnés sous app/migrations/ avec runner atomique et fast-path (<1ms).
• 🎨 Architecture CSS Modulaire : 21 feuilles de style dans 5 répertoires sémantiques.
• 📦 Souveraineté 100% Zero-Cloud : Toutes les dépendances CDN intégrées localement.

📖 Pour l'historique complet et détaillé de toutes les versions antérieures, consultez le CHANGELOG.md.

🇺🇸 English

OmniBank Local is an ultra-private personal and organizational finance management solution, designed for those who demand total control over their data. Combining spreadsheet-like power with local AI intelligence, it transforms financial management into a smooth and secure experience.

[!CAUTION] Disclaimer: The code's security has not undergone any independent audit. Use this application at your own risk and only in a secure local environment.

🌟 Why OmniBank?

• 🔒 Absolute Privacy (Zero Cloud): Your financial data never leaves your machine. Everything is stored locally in a SQLite database.
• 🤖 Local AI Assistant (Ollama): Chat with your finances in natural language. Smart categorization, trend forecasting, and tailored advice without compromising privacy.
• ⚡ Extreme Performance: Virtualized table rendering to handle tens of thousands of transactions seamlessly.
• 🎯 Envelope Budgeting: Intuitive visual envelopes for ongoing spending and savings goals.

✨ Key Features

🏗️ Simplified Setup (Setup Wizard)

From the very first launch, an Initialization Assistant guides you through configuring your accounts, preferences, and connecting your Ollama instance.

📈 Analytics & Daily Management

• Dynamic Dashboard: An overview of your balances, budgets, and upcoming deadlines.
• Virtualized History: Manage thousands of transactions with perfect fluidity thanks to ultra-fast rendering.
• Smart Reconciliation: A visual system to check your operations. Compare bank statements (before) and your clean accounting (after) at a glance.

Transaction entry	History	Reconciliation

🎯 Budget & Envelopes

Suivez vos dépenses par catégories ou par projets avec un système d'enveloppes visuel. L'IA peut même vous suggérer des budgets basés sur vos habitudes.

Vue Budget	Détail Budget	Suggestions IA

🤖 Local AI Assistant

Interact with your personal financial assistant via Ollama. Thanks to RAG (Retrieval-Augmented Generation), the AI accesses your data to answer accurately. It can even propose interactive action cards directly in the chat.

📊 Analytics & Trends

Visualize your financial trajectory and export high-fidelity PDF reports, perfect for strict accounting follow-up or secure sharing.

Monthly Analytics	Long-Term Trends	PDF Export

🛠️ Administration & Customization

Take full control over your financial structure with flexible management tools.

Accounts	Categories	Recurrences	Settings

🏢 Organisation Mode (Associations / Works Councils)

OmniBank includes an organization mode designed for non-profits, sports clubs, works councils (CSE), and small organizations requiring multi-user access.

• 👥 Multi-user without passwords: Every member (treasurer, deputy, secretary…) selects their profile at launch.
• 📋 Built-in audit trail: Every transaction automatically logs who created it and who modified it last.
• 🔑 License required: Activating Organization Mode requires a valid license key.

To obtain a license, open an Issue on GitHub.

🚀 Installation

🖥️ Windows (Recommended)

Download the latest .msi installer from the Releases page.

🐳 Docker

docker-compose up -d --build

Access the interface at http://localhost:8434.

🛠 Technical Stack

• Backend: Python (FastAPI), SQLAlchemy, Pandas.
• Frontend: HTML5/CSS3 (Vanilla), JavaScript, Chart.js.
• Desktop: Tauri (Rust Wrapper).
• AI: Ollama (Text & Vision Support).

🆕 What's New (v1.1.8)

• ⚡ 2× Faster Bank Synchronization (Crédit Agricole): Online statement retrieval is now up to twice as fast by reusing authenticated sessions and intelligently stopping pagination once all relevant transactions have been collected.
• 🔐 Vault Unlock & Sync Flow Consistency: Clicking "Relevé en ligne" now works reliably in all scenarios — vault unlock prompt, cross-browser session re-authorization, and force-sync regardless of anti-spam cooldown state.

📦 Recent History (v1.1.7)

• 📱 Forced Manual Bank Sync & Direct 2FA Auto-Prompt: Instant forced synchronization, automatic interactive 2FA modal, and persistent 90-day SCA session tokens.
• 🛡️ Desktop Startup Resilience & Dual Smoke Tests: Automated sidecar and MSI smoke tests before publication, startup failure fallback screen.

📦 Recent History (v1.1.6)

• 🏛️ Modular SQLite Migrations: 24 sequential version modules under app/migrations/ with atomic runner and fast-path (<1ms).
• 🎨 Modular CSS Architecture: 21 domain stylesheets across 5 semantic directories.
• 📦 100% Zero-Cloud Offline Sovereignty: All CDN dependencies bundled locally.

📖 For the full, detailed history of all previous releases, see the CHANGELOG.md.

🐍 Développement Local / Local Development

1. python -m venv venv
2. .\venv\Scripts\activate
3. pip install -r requirements.txt
4. uvicorn app.main:app --host 127.0.0.1 --port 8434 --reload

📝 Licence / License

Ce projet est disponible en accès partagé (Source-Available) sous la licence propriétaire d'Amify Studio.

• Usage Personnel / Personal Use : Gratuit et autorisé pour un usage strictement individuel et privé. / Free and permitted for strictly individual and private use.
• Usage Organisation / Organizational Use : L'utilisation collective, par une association (Loi 1901, CSE) ou une entreprise (y compris l'activation du "Mode Organisation") requiert l'acquisition d'une clé de licence commerciale. / Any group, non-profit, or corporate use (including enabling "Organisation Mode") requires a commercial license key.
• Détails / Details : Voir le fichier LICENSE pour les termes complets. / See the LICENSE file for full terms.