Skip to content

kanizmadix/finance_tracker

Repository files navigation

Finance Tracker 💰

A comprehensive financial analysis and tracking system that helps analyze spending patterns, financial literacy, and provides insights through data visualization and machine learning models.

📁 Project Structure

├── financial_analysis.py           # Core analysis functions
├── financial_analysis_app.py       # Main application interface
├── model.py                        # Primary ML model implementation
├── modelst.py                      # Student-specific model
├── stmodel.py                      # Statistical modeling
├── student_financial_analysis.py   # Student finance analysis
├── Modified_Cleaned_Data.csv       # Primary dataset
├── Modified_Cleaned_Data_edited.csv# Enhanced dataset
├── expense_analysis.png           # Expense visualization
├── feature_importance.png         # ML feature importance
├── gender_literacy_analysis.png   # Gender-based analysis
├── Ques.docx                      # Documentation
└── Ques-1.docx                    # Additional documentation

🎯 Project Features

Core Functionality

  • Expense tracking and categorization
  • Income and spending pattern analysis
  • Financial literacy assessment
  • Gender-based financial behavior analysis
  • Machine learning predictions
  • Interactive data visualizations

Analysis Components

  1. Expense Analysis

    • Category-wise breakdown
    • Trend analysis
    • Anomaly detection
  2. Financial Literacy

    • Education impact assessment
    • Demographic analysis
    • Behavioral patterns
  3. Predictive Models

    • Spending forecasts
    • Risk assessment
    • Budget recommendations

🛠️ Technical Setup

Prerequisites

- Python 3.8+
- pandas
- numpy
- scikit-learn
- matplotlib
- seaborn
- streamlit (for app interface)

Installation

  1. Clone the repository:
git clone https://github.com/kanizmadix/finance_tracker.git
cd finance_tracker
  1. Install dependencies:
pip install -r requirements.txt

🚀 Usage

Running the Analysis

  1. Core Analysis:
python financial_analysis.py
  1. Interactive App:
streamlit run financial_analysis_app.py
  1. Student-Specific Analysis:
python student_financial_analysis.py

Data Input

The system accepts financial data in CSV format with the following structure:

  • Transaction details
  • Amount
  • Category
  • Date
  • Demographics
  • Financial literacy indicators

📊 Visualizations

  1. Expense Analysis (expense_analysis.png)

    • Category-wise spending distribution
    • Time-series analysis
    • Spending patterns
  2. Feature Importance (feature_importance.png)

    • Key factors affecting financial behavior
    • Impact weights of different variables
  3. Gender Literacy Analysis (gender_literacy_analysis.png)

    • Gender-based financial patterns
    • Literacy correlation analysis

📈 Analysis Features

Financial Metrics

  • Monthly spending patterns
  • Budget adherence
  • Savings rate
  • Risk assessment

Machine Learning Models

  • Spending prediction
  • Category classification
  • Anomaly detection
  • Risk scoring

🤝 Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/Enhancement)
  3. Commit your changes (git commit -m 'Add Enhancement')
  4. Push to the branch (git push origin feature/Enhancement)
  5. Open a Pull Request

📝 Documentation

Detailed documentation is available in:

  • Ques.docx: Primary documentation
  • Ques-1.docx: Supplementary information

🔒 Security

  • Sensitive financial data is handled securely
  • Personal information is encrypted
  • Compliance with financial data regulations

📊 Reports

The system generates various reports:

  1. Monthly Financial Summary
  2. Spending Pattern Analysis
  3. Budget Performance
  4. Risk Assessment Report

🎯 Future Enhancements

  • Real-time transaction tracking
  • Mobile app integration
  • Advanced predictive analytics
  • Investment portfolio analysis
  • Multi-currency support

📫 Contact

Project Maintainer: KANISHK S GitHub: @kanizmadix

📜 License

This project is licensed under the MIT License - see the LICENSE.md file for details


⭐ If you find this tool helpful, please star the repository!

Note: This tool is designed for educational and personal use. For professional financial advice, please consult with qualified financial advisors.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages