FinanzPilot - Selbstgehosteter persönlicher Finanzmanager

Die Kontrolle über persönliche Finanzen mit Open Source übernehmen

FinanzPilot ist eine selbstgehostete Webanwendung für persönliche Finanzen, die Datenhoheit an erste Stelle setzt. Entwickelt mit Laravel 13 und Vue 3, bietet sie eine moderne, vollwertige Alternative zu cloudbasierten Finanztools — ohne Abogebühren oder Datenweitergabe an Dritte. Alle Finanzdaten bleiben auf dem eigenen Server, gespeichert in einer einzigen SQLite-Datei, die sich einfach sichern und migrieren lässt.

Die Herausforderung

Bestehende Tools für persönliche Finanzen stellen Nutzer vor eine schwierige Wahl:

• Cloud-Abhängigkeit: Beliebte Apps speichern sensible Finanzdaten auf Drittanbieter-Servern mit eingeschränkten Exportmöglichkeiten
• Fehlende deutsche Bankenunterstützung: Die meisten Tools bieten keinen Import für deutsche Bank-CSV-Formate von Sparkasse, PayPal oder anderen lokalen Instituten
• Abo-Müdigkeit: Nützliche Funktionen verstecken sich hinter wiederkehrenden Zahlungen für ein grundsätzlich lokales Datenproblem
• Keine KI-Integration: Klassische Finanztools können moderne KI nicht für Ausgabenanalyse oder Finanzeinblicke nutzen
• Datenschutzbedenken: Das Senden von Transaktionsdaten an externe Dienste wirft erhebliche Datenschutzfragen auf

Datenschutzbewusste Nutzer und Entwickler wollen volle Hoheit über ihre Finanzdaten, ohne auf ein modernes Nutzererlebnis verzichten zu müssen.

Die Lösung

FinanzPilot kombiniert ein Laravel-13-Backend mit einem Vue-3-Frontend über Inertia.js und liefert ein reaktives Single-Page-Application-Erlebnis mit serverseitigem Rendering. SQLite eliminiert die Komplexität eines Datenbankservers — die gesamte Datenbank ist eine einzige Datei. Docker-Compose-Paketierung ermöglicht unkompliziertes Deployment auf jedem Server oder NAS. KI-gestützte Einblicke sind über mehrere Anbieter verfügbar (Claude, OpenAI, Ollama) mit automatischer Datenanonymisierung vor jedem externen API-Aufruf.

Hauptmerkmale

• Interaktives Dashboard: ApexCharts-gestützte Visualisierungen für Einnahmen-/Ausgabentrends, Kategorieaufteilungen, Kontoverlauf und Sparquoten-Tracking
• Bank-CSV-Import: Integrierte Parser für Sparkasse- und PayPal-CSV-Formate sowie ein generischer CSV-Importer für andere Institute
• Intelligente Kategorisierung: Selbstlernende Regel-Engine, die sich mit jeder manuellen Kategorisierung verbessert und gelernte Regeln automatisch auf zukünftige Transaktionen anwendet
• Multi-Konto-Verwaltung: Girokonten, Sparkonten, Kreditkarten und Bargeld getrennt verfolgen mit individueller Saldenverfolgung
• Wiederkehrende Transaktionen: Vorlagen für Miete, Gehalt, Abonnements und andere regelmäßige Zahlungen mit automatischer Generierung
• Kreditverwaltung: Bankkredite mit Tilgungsplänen und informelle Schulden mit Zahlungshistorie verfolgen
• Excel-Export: Deutsch formatierte .xlsx-Dateien für den Steuerberater, mit korrekter Zahlenformatierung und Kategoriezusammenfassungen
• KI-gestützte Einblicke: Finanzanalyse mit Claude, OpenAI oder Ollama mit Privacy-First-Datenanonymisierung — Transaktionsdetails werden vor dem Verlassen des Servers von identifizierenden Informationen befreit
• MCP-Server-Integration: Model-Context-Protocol-Server, der Claude Code oder Claude Desktop ermöglicht, Kontosalden, Transaktionen und Ausgabemuster im Gespräch abzufragen
• Docker-Deployment: Produktionsfertige Docker-Compose-Konfiguration mit nginx und PHP-FPM für einfaches Self-Hosting

Technische Umsetzung

Das Projekt demonstriert Full-Stack-Architekturentscheidungen, optimiert für Datenschutz und Einfachheit:

Backend-Architektur:

• Laravel 13 auf PHP 8.4 mit SQLite für konfigurationsfreie Persistenz
• Single-File-Datenbank ermöglicht triviale Backups und Migration
• Geplante Tasks für automatische Generierung wiederkehrender Transaktionen
• PHPOffice/PHPSpreadsheet für deutsch-lokalisierte Excel-Exporte

Frontend-Stack:

• Vue 3 mit Inertia.js für SPA-artige Reaktivität ohne separate API-Schicht
• PrimeVue-Komponentenbibliothek für konsistente, barrierefreie UI-Elemente
• Tailwind CSS für Utility-First-Styling
• ApexCharts für interaktive, responsive Datenvisualisierungen

KI-Integration:

• Adapter-Pattern mit Unterstützung für Claude (Anthropic API), OpenAI-kompatible APIs und Ollama für vollständig offline Betrieb
• Automatische PII-Anonymisierungs-Pipeline entfernt Kontonamen, Transaktionsbeschreibungen und persönliche Identifikatoren vor dem Senden an externe KI-Anbieter
• Konfigurierbare Anbieter-Einstellungen für Modellauswahl und API-Endpunkte

MCP-Server:

• Node.js-basierter Model-Context-Protocol-Server
• Stellt Kontosalden, Transaktionsabfragen und Ausgabenanalysen als MCP-Tools bereit
• Ermöglicht natürlichsprachliche Finanzabfragen aus Claude Code oder Claude Desktop

Import-Pipeline:

• Erweiterbare CSV-Parser-Architektur mit formatspezifischen Adaptern
• Automatisches Feld-Mapping für unterstützte Bankformate
• Duplikaterkennung zur Vermeidung von Doppelimporten

Kategorisierungs-Engine:

• Regelbasiertes System, das aus Nutzerkorrekturen lernt
• Musterabgleich auf Transaktionsbeschreibungen, Beträge und Gegenparteien
• Regeln bauen sich über die Zeit auf und reduzieren manuelle Kategorisierung auf Einzelfälle

Warum Self-Hosting wichtig ist

• Vollständige Datenhoheit: Finanzdaten verlassen nie den eigenen Server, es sei denn, KI-Funktionen werden explizit aktiviert — und selbst dann werden Daten anonymisiert
• Keine laufenden Kosten: MIT-lizenzierte Open Source ohne Abogebühren oder Premium-Stufen
• Deutsches Banking-Ökosystem: Native Unterstützung für deutsche Bank-CSV-Formate und deutsch formatierte Excel-Exporte für die Steuererklärung
• Privacy-First-KI: Intelligente Finanzeinblicke ohne Kompromisse beim Datenschutz auf Transaktionsebene durch automatische Anonymisierung
• Erweiterbare Architektur: Das Hinzufügen neuer Bank-Importformate oder KI-Anbieter erfordert nur die Implementierung eines einzelnen Adapters
• MCP-Integration: Verbindet persönliche Finanzdaten mit KI-gestützten Workflows und ermöglicht konversationelle Abfragen zu Ausgabemustern und Kontostatus