X-Analytics is a next-generation personal finance application that evolves beyond simple tracking. It features a "Master Brain"—a Deep Learning LSTM Neural Network—that analyzes your spending sequence to predict future financial trends with high accuracy.
Wrapped in a modern, professional dark-themed interface, it offers real-time visualization, smart budget enforcement, and deep financial insights.
Figure 1: The Modern Dark Dashboard visualizing monthly net flow and recent transactions.
Unlike standard apps that use simple averages, X-Analytics uses a Long Short-Term Memory (LSTM) Neural Network to understand the sequence of your spending.
- Context-Aware: Recognizes patterns like weekend spikes, monthly bills, or seasonal habits.
- 30-Day Lookback: Analyzes your last 30 days of history to predict the next month's total expense.
- Visual Forecast: Plots a dashed "Future Line" against your historical data to show exactly where your finances are heading.
Figure 2: The AI "Master Brain" predicting future spending trends based on historical data.
- Smart Budgeting: Set monthly limits with visual progress bars.
- NEW: Includes a "Reset Budget" feature to clear limits instantly.
- Alerts: Real-time warnings if a transaction will exceed your budget.
- Loan Tracker: Dedicated module to manage debts, log "Requests" (borrowing), and "Repayments."
- Transaction Logging: Seamlessly add Income, Expenses, and Transfers between accounts.
- Sleek Dark Mode: Built with
CustomTkinterfor a professional, eye-friendly aesthetic (#1A1A2Etheme). - Interactive Sidebar: Quick navigation between Dashboard, Income, Expense, Loans, and AI tools.
- Asynchronous Processing: The AI runs on background threads, ensuring the app never freezes while "thinking."
- Demo Mode: Includes a Dummy Data Generator to instantly create 6 months of realistic test data so you can see the AI in action immediately.
This project is built using a robust stack of Python libraries:
| Component | Library | Purpose |
|---|---|---|
| GUI | customtkinter |
Modern, high-DPI, dark-mode user interface. |
| AI Core | tensorflow / keras |
Building and running the LSTM Neural Network. |
| Data Logic | pandas / numpy |
High-performance data manipulation and scaling. |
| Plotting | matplotlib |
Generating dynamic financial graphs and trend lines. |
| Image | Pillow (PIL) |
Rendering charts within the GUI. |
Follow these steps to get the Master Brain running on your local machine.
git clone [https://github.com/haroon-ai1/personal-Finance-Manager-Application-Python-.git](https://github.com/haroon-ai1/personal-Finance-Manager-Application-Python-.git)
cd personal-Finance-Manager-Application-Python- pip install customtkinter tensorflow pandas numpy scikit-learn matplotlib pillow
The application needs a trained "Brain" file to function. You must run the training script once before opening the app.
- Ensure the dataset
Personal_Finance_Dataset.csvis in the project folder. - Run the training script:
python train_model.py
- Wait for the process to finish. It will generate a file named
finance_brain.keras.
Now you can launch the dashboard:
python gui.py
gui.py: The frontend application. Handles the Dark UI, navigation, threading, and user interaction.logic.py: The backend engine. Handles database (CSV) operations, data processing, and loads the AI model for predictions.train_model.py: The "Teacher." Reads raw data, normalizes it, and trains the LSTM Neural Network to create the model file.users.txt: Secure storage for user credentials and account balances.transactions.csv: The ledger containing every income, expense, and transfer.
Contributions are welcome! If you have ideas for better AI models, new UI themes, or additional features:
- Fork the repository.
- Create a feature branch.
- Submit a Pull Request.
This project is developed by Haroon and is available for educational and open-source use.