Fintellect User Guide
Fintellect is a data-driven personal finance dashboard that transforms raw bank statements into visualized financial insights. This Flask-powered web application automatically categorizes transactions, tracks spending patterns, and presents your financial data through interactive charts and graphs - helping you understand where your money goes and how to optimize your spending.
Key Features:
-
Automated Categorization: Intelligently classifies transactions into spending categories
-
Interactive Visualizations:
-
Pie charts showing spending distribution
-
Time-series graphs of daily and accumulated expenses
-
Combined views for trend analysis
-
CSV Integration: Works with exported bank statement CSVs
-
Responsive Design: Accessible on both desktop and mobile devices
Perfect for:
-
Individuals wanting better visibility into their spending habits
-
Budget-conscious users tracking expenses over time
-
Financial beginners looking for an intuitive money management tool
Built with:
-
Python/Flask backend
-
Plotly for visualizations
-
Pandas for data processing
-
Bootstrap for responsive UI
๐ Prerequisites
Before using this application, ensure you have:
- Python 3.8+ installed
- pip package manager
- (Optional) Virtual environment (recommended)
๐ ๏ธ Setup Instructions
- Install dependencies:
pip install -r requirements.txt
Prepare your data:
The app expects CSV files with these required columns:
-
date (format: YYYY-MM-DD)
-
amount (numeric values)
-
transaction_type (should include "Expense" entries)
-
auto_category (spending categories)
Example CSV structure:
date,amount,description,transaction_type,auto_category
2023-01-01,15.50,Coffee shop,Expense,Eating Out
2023-01-02,120.00,Supermarket,Expense,Groceries
๐ How to Use the Application
1. Launch the Application
The application will start at http://localhost:8000

2. Upload Your Data
3. View Your Dashboard
After successful upload, you'll be automatically redirected to the dashboard with three visualizations:
Spending by Category (Pie Chart)
Daily Spending (Line Chart)
Accumulated Spending (Line Chart)
๐ Example Walkthrough
-
Prepare a CSV file with your financial data
-
Upload the file through the web interface

-
Review your uploaded expenses and edit the categories as necessary
-
Explore your dashboard:
-
Identify largest spending categories
-
Track daily spending patterns
-
Monitor accumulated expenses over time
โ ๏ธ Known Limitations
-
Currently only supports CSV files (no Excel or JSON)
-
Maximum file size: 10MB
-
Date range limited to 2 years for optimal performance
-
Categories are case-sensitive ("Groceries" โ "groceries")
๐ Getting Help
For additional support:
-
Check the docs/ directory for detailed documentation
-
Open an issue on GitHub for bug reports
-
You can host these images in your repo's /docs/images folder or use an image hosting service.