Skip to content

SAKKU3/FinSight-Your-Smart-Companion-for-Financial-Clarity

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

💸 FinSight -Your-Smart-Companion-for-Financial-Clarity

FinSight is a smart, user-centric financial analysis platform designed to turn personal expense data into actionable insights. It enables users to track income, analyze spending patterns, measure savings, and receive AI-generated recommendations — all through a refined, intuitive interface.

This project includes versions tailored for both USD (Code_USA.py) and INR (code_India.py) users, making it adaptable for global and local audiences.


📊 Demo Preview

Interactive Financial Summary:

  • 📄 PDF Report Snapshot – Downloadable overview of your income, expense breakdown, and personalized suggestions
  • 📈 Real-time charts, savings rate, and financial score based on uploaded CSV

🚀 Key Features

  • 💰 Income vs. Expense Analysis – Calculates total expenses, savings, and income gap
  • 📊 Category-Based Expense Visualization – Interactive pie/bar charts for quick spending insights
  • 🔍 Financial Health Score (0–100) – Dynamically computed based on savings rate and patterns
  • 🧠 AI-Ready Architecture – Integrate ML models to forecast savings or classify financial behavior
  • 🌐 Currency Localization – Choose between USD and INR with seamless conversion logic
  • 📄 Exportable Reports – Generate PDF summaries and downloadable CSVs (upcoming)

🧠 AI/ML-Enabled Capabilities (Pluggable)

FinSight is structured to support AI/ML extensions, such as:

  • 📈 Savings Prediction Model – Uses Linear Regression to forecast next month’s savings
  • 🔍 Spending Behavior Clustering – Groups users into Saver, Spender, or Balanced categories using K-Means
  • ⚠️ Anomaly Detection – Detects unexpected expense spikes
  • 📆 Time-Series Forecasting – Apply LSTM to project long-term financial health
  • 📝 NLP Summary Generation – Converts numeric reports into human-friendly recommendations

🧩 How It Works

  1. User uploads a CSV file containing monthly income and categorized expenses.
  2. Data is analyzed to compute:
    • Total income & expenses
    • Category-wise spending
    • Savings rate
    • Financial score (0–100)
  3. AI-generated personalized insights are displayed.
  4. Optional: Export the full summary report as a PDF.

💼 Use Cases

Role Benefit
🎓 Students Learn to manage limited budgets and track spending
👨‍💼 Professionals Analyze cash flow and receive alerts for overspending
👨‍👩‍👧‍👦 Families Visualize and optimize household expenses
📊 Analysts Extend the platform with ML for deeper research
💻 Developers Use as a base template for fintech applications

🔧 Project Structure

FinSight/
│
├── Code_USA.py               # Core logic for USD-based financial dashboard
├── code_India.py             # INR-adapted dashboard with conversion logic
├── file.csv                  # Sample user financial data
├── picture.pdf               # Dashboard snapshot for reporting
├── savings_predictor_model.pkl (optional) # Trained AI model (if integrated)
└── README.md                 # Project documentation

🛠️ Installation & Setup

📦 Prerequisites

  • Python 3.7+
  • pandas, matplotlib, plotly, joblib
  • (Optional for AI): scikit-learn, numpy

📥 Clone and Install

git clone https://github.com/your-username/FinSight.git
cd FinSight
pip install -r requirements.txt

▶️ Run the Dashboard

For USA:

python Code_USA.py

For India:

python code_India.py

🌟 Challenges Faced

  • 🧾 Balancing Simplicity with Insight: Making the UI intuitive while offering valuable financial metrics
  • 💱 Currency Localization: Ensuring smooth and accurate USD–INR conversion
  • 🤖 Scalable AI Integration: Structuring the codebase to easily plug in predictive models
  • 📉 Data Design: Creating realistic and customizable sample datasets for varied scenarios

🔮 Future Enhancements

  • 📤 Upload historical data for trend analysis
  • 🧾 OCR-based expense extraction from receipts
  • 🧠 AI-powered chatbot for finance-related Q&A
  • 📆 Month-to-month comparisons and goal tracking
  • 🌍 Deployment on Streamlit Cloud or Hugging Face Spaces

🧑‍💻 Author

Mohammad Saqlain
B.Tech in Artificial Intelligence & Data Science
Specialized in predictive modeling, data visualization, and financial AI systems


📄 License

This project is licensed under the MIT License – feel free to fork, adapt, and build upon it.


“Master your money before it masters you.”
– FinSight

About

FinSight is an intelligent financial analysis tool that helps users track income, expenses, and savings with personalized insights. Supporting USD and INR, it offers visual dashboards, AI-ready architecture for forecasting, and exportable reports—ideal for students, professionals, and fintech projects.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages