Omnibank-local

Omnibank-local

Docker app from Asch3's Repository

🇬🇧 English OmniBank-Local is a financial backend initially designed for desktop, but adapted to run autonomously on Unraid via Docker.

Overview
🇬🇧 English OmniBank-Local is a financial backend initially designed for desktop, but adapted to run autonomously on Unraid via Docker. Data is persistently stored in the mapped appdata folder. 🔒 Optional: set OMNIBANK_PASSWORD to protect your instance with Basic Auth (recommended if accessible from other devices on your network). 🇫🇷 Français OmniBank-Local est un backend financier conçu initialement pour le desktop, mais adapté pour fonctionner en autonomie sur Unraid via Docker. Les données sont stockées de façon persistante dans le dossier appdata mappé. 🔒 Optionnel : définissez OMNIBANK_PASSWORD pour protéger votre instance par mot de passe (recommandé si accessible depuis d'autres appareils sur votre réseau). ⚠️ DISCLAIMER: This application is provided "as-is". It is a personal project in active development and "100% vibe coded" for my own needs. Use at your own risk. / Cette application est fournie "telle quelle". C'est un projet personnel en développement actif, "100% vibe coded" pour mes propres besoins. À utiliser à vos risques et périls.

OmniBank Local 🏦

Français • English

---

🇫🇷Version

Publisher Tech

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.

Dashboard Overview

[!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.

Setup Wizard

📈 Analytique & Gestion Quotidienne

  • Cockpit & Journal : Le Cockpit résume votre cycle en un coup d'œil (reste à vivre, rythme de dépense, patrimoine net), le Journal liste les opérations à saisir et rapprocher ; moyennes et top des dépenses sont dans Tendances.
  • 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
Saisie d'opération Historique des transactions Dashboard avec 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
Vue Budget Détail d'un budget Suggestions IA pour budgets

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

Chat IA

📊 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
Synthèse mensuelle Tendances long terme 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
Gestion des comptes Gestion des catégories Opérations récurrentes Configuration globale

Propagation des modifications


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

Le Mode Organisation est momentanément hors de la vente, pour une durée indéterminée. Si vous disposez déjà d'une licence, saisissez votre clé dans la Configuration.


🚀 Installation

🖥️ Windows (Recommandé)

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

🐳 Docker

Image prête à l'emploi (amd64 et arm64), par exemple pour Unraid ou un NAS : aschefr/omnibank-local:latest, port 8434, données dans le volume /app/data.

Depuis les sources :

docker-compose up -d --build

Accédez à l'interface sur http://localhost:8434. Le docker-compose.yml n'écoute que sur la machine locale : pour y accéder depuis un autre appareil du réseau (téléphone, autre PC), lancez-le avec OMNIBANK_BIND_IP=0.0.0.0.


🛠 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.3.0)

  • 🎛️ Cockpit en Page d'Accueil & Navigation Repensée : le Cockpit devient la page d'accueil, l'ancien Dashboard devient « Journal » et le Tableau de bord complet est retiré (les anciens liens ouvrent le Cockpit). Carte patrimoine net, jauge de cadence qui compte les dépenses dès qu'elles ont lieu, et menu « Plus » au lieu du défilement horizontal des onglets.
  • 📱 Refonte Mobile : barre d'onglets en bas, cartes d'opération compactes, formulaire plein écran (montant d'abord) et tableaux lisibles sur téléphone (Récurrences, Synthèse, Tendances).
  • 🤖 Assistant IA Repensé : réponses plus courtes et fiables, actions proposées avant d'être préparées, personnalité et guide de l'interface modifiables, aperçu du prompt final, questions de démarrage et mémoire des longues conversations (résumé automatique sans bloquer l'application).
  • 🔐 Code PIN Appliqué par le Serveur & Sauvegardes Chiffrées : un profil protégé exige un déverrouillage (essais limités, code de récupération) et ses données sont chiffrées dans les sauvegardes globales.
  • ⚙️ Configuration Réorganisée : six sections claires, actions sensibles regroupées dans une « Zone de danger » repliée, page deux fois plus courte sur téléphone.

📦 Historique Récent (v1.2.11)

  • ⚡ Navigation Instantanée & Caching SWR Multi-Vues : Rendu instantané et non-bloquant des vues (Dashboard, Historique, Synthèse, Budgets, Tendances, Récurrences, Simulateur) via le pattern Stale-While-Revalidate (SWR) et parallélisation des requêtes, abaissant les transitions sous 380ms.
  • ⏱️ Filtrage Côté Serveur & Fenêtrage Scoped (Timeline & Récurrences) : Réduction de plus de 90% des charges utiles de transactions grâce au fenêtrage ciblé (timeline_window et has_recurrence), avec bascule transparente vers l'historique complet à la demande.
  • 🎯 Cadence Financière Serveur & Parité de Rendu Stricte (Navigation vs F5) : Nouveau endpoint optimisé /api/stats/rhythm avec calcul des moyennes IQR sans latence client et résolution préalable des comptes actifs pour une parité 100% stricte entre sessions et démarrage à froid (Zero F5).
  • 🤖 Fenêtre d'Opération Unifiée & Rapprochement Prévisionnel Auto-Pilote : Modale unifiée permettant de lier n'importe quelle opération bancaire à une prévision comptable avec sélection chronologique, défilement automatique, traçabilité des décisions et déliaison bidirectionnelle réversible.

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


🇺🇸 English

Version Publisher Tech

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.

Dashboard Overview

[!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.

Setup Wizard

📈 Analytics & Daily Management

  • Cockpit, Dashboard & Ledger: the Cockpit sums up your cycle at a glance (remaining budget, spending pace), the Dashboard details balances and averages, the Ledger lists the operations to enter and reconcile.
  • 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
Transaction entry Transaction history Dashboard with 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
Vue Budget Détail d'un budget Suggestions IA pour budgets

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

Chat IA

📊 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
Monthly Summary Long-term trends PDF Export

🛠️ Administration & Customization

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

Accounts Categories Recurrences Settings
Account Management Category Management Recurring operations Global Settings

Change Propagation


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

Organisation Mode is temporarily off sale, for an indefinite period. If you already have a license, enter your key in Configuration.


🚀 Installation

🖥️ Windows (Recommended)

Download the latest .msi installer from the Releases page.

🐳 Docker

Ready-to-use image (amd64 and arm64), for example on Unraid or a NAS: aschefr/omnibank-local:latest, port 8434, data in the /app/data volume.

From source:

docker-compose up -d --build

Access the interface at http://localhost:8434. The docker-compose.yml only listens on the local machine: to reach it from another device on your network (phone, other PC), start it with OMNIBANK_BIND_IP=0.0.0.0.


🛠 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.3.0)

  • 🎛️ Cockpit as Home Page & Reworked Navigation: The Cockpit is now the landing page, the former Dashboard is renamed "Journal" and the full "Tableau de bord" is retired (old links open the Cockpit). Net worth card, a pace gauge that counts spending as soon as it happens, and a "More" menu instead of sideways-scrolling tabs.
  • 📱 Mobile Redesign: Bottom tab bar, compact operation cards, a full-screen operation form (amount first) and tables that read well on phones (Recurrences, Analytics, Trends).
  • 🤖 Reworked AI Assistant: Shorter, more reliable answers, actions offered before being prepared, editable personality and interface guide, a final prompt preview, starter questions and memory for long conversations (automatic summary without freezing the app).
  • 🔐 Server-Enforced Profile PIN & Encrypted Backups: A protected profile must be unlocked (rate-limited, with a recovery code), and its data is encrypted in global backups.
  • ⚙️ Reorganised Configuration: Six clear sections, sensitive actions grouped in a folded "Danger zone", and a page half as long on phones.

📦 Recent History (v1.2.11)

  • ⚡ Instant View Navigation & Multi-View SWR Caching: Non-blocking instant view rendering across Dashboard, Operations History, Analytics, Budgets, Trends, Recurrences, and Simulator using Stale-While-Revalidate (SWR) caching and parallel fetching, dropping screen transitions below 380ms.
  • ⏱️ Server-Side Targeted Windowing (Timeline & Recurrences): Drops transaction payload by over 90% with server-side windowing (timeline_window and has_recurrence), while providing seamless, on-demand fallback to full history for older cycles.
  • 🎯 Server-Side Financial Rhythm & Strict Render Parity (Navigation vs F5): Dedicated cached /api/stats/rhythm endpoint computing robust IQR averages in under 1ms with pre-resolved active account state, guaranteeing 100% strict equality between navigation and cold reloads (Zero F5).
  • 🤖 Unified Operation Modal & Auto-Pilot Forecast Linking: Unified editing dialog to directly link bank transactions to accounting forecasts with chronological candidate matching, auto-scrolling, human override tracking, and reversible bi-directional unlinking.

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

Media gallery

1 / 3

Categories

Download Statistics

6,950
Total Downloads

Related apps

Links

Details

Repository
aschefr/omnibank-local:latest
Last Updated2026-11-01
First Seen2026-06-16

Runtime arguments

Web UI
http://[IP]:[PORT:8434]
Network
bridge
Shell
bash
Privileged
false

Template configuration

WebUI PortPorttcp

Web UI access port (and API) / Port d'accès à l'interface web (et API)

Target
8434
Default
8434
Value
8434
Configuration and DataPathrw

Storage for database and uploaded files / Stockage de la base de données et des fichiers

Target
/app/data
Default
/mnt/user/appdata/omnibank-local
Value
/mnt/user/appdata/omnibank-local
Password (optional)Variable

Optional: set a password to protect your instance with Basic Auth. Leave empty for open access (default). / Optionnel : définissez un mot de passe pour protéger votre instance. Laissez vide pour un accès libre (par défaut).

Target
OMNIBANK_PASSWORD
DATABASE_URLVariable

Internal database configuration (Do not modify)

Default
sqlite:///./data/omnibank.db
Value
sqlite:///./data/omnibank.db
TimezoneVariable

Container timezone

Target
TZ
Default
Europe/Paris
Value
Europe/Paris