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 ?

• 🔒 Confidentialité Absolue (Zéro Cloud) : Vos données financières ne quittent jamais votre machine. Tout est stocké localement dans une base SQLite.
• 🤖 Assistant IA Local (Ollama) : Interagissez avec vos finances en langage naturel. Catégorisation intelligente, analyses de tendances et conseils personnalisés sans compromettre votre vie privée.
• ⚡ Performance Extrême : Grâce au rendu virtualisé, gérez des milliers de transactions sans aucun ralentissement.
• 🎯 Gestion par Enveloppes : Un système budgétaire visuel et intuitif pour suivre vos projets et vos dépenses courantes.

✨ 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 avec 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.0.88)

• ⏳ Détection des Opérations en Attente : Récupération automatique des opérations non encore imputées (autorisations carte, prélèvements à venir) avec badge distinctif ⏳ À venir et indicateurs de discordance d'état bancaire.
• 🔗 Liaison Automatique des Virements Orphelins : Identification et fusion automatique des écritures isolées inter-comptes en virements internes, éliminant les doublons lors de la synchronisation multi-comptes.
• ⚖️ Indicateur de Conformité des Soldes : Comparaison automatique du solde pointé local avec le solde bancaire distant, avec guide de validation delta et badges 🎯 Résout l'écart.
• 🎨 États de Rapprochement Unifiés : Centralisation de la logique de rapprochement dans un module unique, distinguant visuellement les opérations à venir (⏳) des opérations confirmées (⚡) à travers toutes les vues.
• 🏗️ Refactoring Modulaire Bank Sync : Extraction du monolithe bank_sync.js en 5 sous-modules focalisés pour une meilleure maintenabilité.

📖 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): Interact with your finances using natural language. Intelligent categorization, trend analysis, and personalized advice without compromising your privacy.
• ⚡ Extreme Performance: Thanks to virtualized rendering, manage thousands of transactions without any slowdown.
• 🎯 Envelope Management: A visual and intuitive budgeting system to track your projects and daily expenses.

✨ 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

Track your spending by categories or projects with a visual envelope system. The AI can even suggest budgets based on your habits.

Budget View	Budget Detail	AI Suggestions

🤖 Local AI Assistant

Interact with your personal financial assistant via Ollama. Using RAG (Retrieval-Augmented Generation), the AI accesses your data to provide precise answers. It can even submit interactive action proposals directly in the chat.

📊 Synthesis & Trends

Visualize the evolution of your wealth and generate high-fidelity PDF reports, perfect for rigorous accounting tracking or secure sharing.

Synthesis	Trends	PDF Export

🛠️ Administration & Customization

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

Accounts	Categories	Recurrences	Configuration

🏢 Organisation Mode (Nonprofits / Work Councils)

OmniBank offers an organisation mode designed for nonprofits, work councils, and small organizations needing multi-user tracking.

• 👥 Password-free multi-user: Each member (treasurer, deputy, secretary…) selects their profile at launch.
• 📋 Built-in audit trail: Every transaction automatically records who created it and who last modified it.
• 🔑 License required: Activating organisation mode requires a 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.0.88)

• ⏳ Upcoming Transactions Detection: Automatically fetches unposted/pending bank operations (card authorizations, upcoming direct debits) with a distinctive ⏳ Upcoming badge and bank state discrepancy indicators.
• 🔗 Orphan Internal Transfer Auto-Linking: Automatically identifies and merges isolated single-leg transactions across accounts into internal transfers, eliminating duplicates when syncing multiple bank accounts.
• ⚖️ Bank Balance Consistency Indicator: Automatic comparison of local reconciled balance with remote bank balance, with delta-guided validation and 🎯 Resolves difference badges.
• 🎨 Unified Reconciliation States: Centralized reconciliation logic into a single module, visually distinguishing upcoming (⏳) from confirmed (⚡) operations across all views.
• 🏗️ Bank Sync Modular Refactoring: Extracted the monolithic bank_sync.js into 5 focused sub-modules for improved maintainability.

📖 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.