{"id":28923995,"url":"https://github.com/tillscode/personal-finance-ml-analysis","last_synced_at":"2026-04-28T00:31:49.530Z","repository":{"id":297140803,"uuid":"995783130","full_name":"tillscode/personal-finance-ml-analysis","owner":"tillscode","description":"Machine learning analysis of personal financial data with predictive modeling and interactive dashboard","archived":false,"fork":false,"pushed_at":"2025-06-05T00:35:33.000Z","size":26,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-22T10:03:10.998Z","etag":null,"topics":["dashboard","data-analysis","finance","machine-learning","python","scikit-learn"],"latest_commit_sha":null,"homepage":"https://github.com/tillscode/personal-finance-ml-analysis","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tillscode.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-04T02:15:00.000Z","updated_at":"2025-06-05T00:35:35.000Z","dependencies_parsed_at":"2025-06-08T04:30:24.453Z","dependency_job_id":null,"html_url":"https://github.com/tillscode/personal-finance-ml-analysis","commit_stats":null,"previous_names":["tillscode/personal-finance-ml-analysis"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/tillscode/personal-finance-ml-analysis","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tillscode%2Fpersonal-finance-ml-analysis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tillscode%2Fpersonal-finance-ml-analysis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tillscode%2Fpersonal-finance-ml-analysis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tillscode%2Fpersonal-finance-ml-analysis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tillscode","download_url":"https://codeload.github.com/tillscode/personal-finance-ml-analysis/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tillscode%2Fpersonal-finance-ml-analysis/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32361477,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-27T20:07:02.737Z","status":"ssl_error","status_checked_at":"2026-04-27T20:07:00.910Z","response_time":128,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dashboard","data-analysis","finance","machine-learning","python","scikit-learn"],"created_at":"2025-06-22T10:02:43.121Z","updated_at":"2026-04-28T00:31:49.525Z","avatar_url":"https://github.com/tillscode.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Personal Finance ML Analysis\r\n\r\n## 🎯 Project Overview\r\n\r\nThis project analyzes 15+ months of personal financial data from multiple sources to build predictive models for expense forecasting and spending pattern analysis. The project demonstrates advanced data science skills including data integration, feature engineering, machine learning, and interactive visualization.\r\n\r\n### Key Achievements\r\n- **Integrated data from 3 financial sources** (1,571+ transactions)\r\n- **Built ML models with ±$580 prediction accuracy** using scikit-learn\r\n- **Developed interactive dashboard** with Plotly for insights visualization\r\n- **Detected spending anomalies** (travel months) with business context\r\n- **Created actionable financial insights** for budget planning\r\n\r\n## 📊 Key Results\r\n\r\n| Metric | Value |\r\n|--------|-------|\r\n| **ML Model Accuracy** | ±$580 MAE |\r\n| **Data Sources Integrated** | 3 (Wells Fargo, Discover, Chase) |\r\n| **Transactions Analyzed** | 1,571+ |\r\n| **Analysis Period** | 15 months |\r\n| **Variance Explained (R²)** | 0.847 |\r\n| **Top Spending Category** | Restaurants ($2,598) |\r\n\r\n## 🛠️ Technical Stack\r\n\r\n**Data Processing \u0026 Analysis:**\r\n- **Python** - Core programming language\r\n- **Pandas** - Data manipulation and analysis\r\n- **NumPy** - Numerical computing\r\n\r\n**Machine Learning:**\r\n- **scikit-learn** - ML algorithms and evaluation\r\n- **Ridge Regression** - Best performing model\r\n- **Random Forest** - Feature importance analysis\r\n\r\n**Visualization:**\r\n- **Plotly** - Interactive dashboard creation\r\n- **Matplotlib** - Statistical visualizations\r\n\r\n## ⚡ Quick Start\r\n\r\n### Prerequisites\r\n```bash\r\nPython 3.8+\r\npip package manager\r\n```\r\n\r\n### Installation\r\n```bash\r\n# Clone the repository\r\ngit clone https://github.com/tillscode/personal-finance-ml-analysis.git\r\ncd personal-finance-ml-analysis\r\n\r\n# Install dependencies\r\npip install -r requirements.txt\r\n```\r\n\r\n### Usage\r\n```bash\r\n# 1. Process and clean data\r\npython 1_data_processing.py\r\n\r\n# 2. Train ML models\r\npython 2_ml_modeling.py\r\n\r\n# 3. Create interactive dashboard\r\npython 3_interactive_dashboard.py\r\n```\r\n\r\n## 📈 Analysis Highlights\r\n\r\n### 🔍 Data Integration\r\n- **Multi-source consolidation** from 3 financial institutions\r\n- **Standardized data formats** across different CSV structures\r\n- **Data quality validation** with comprehensive error handling\r\n\r\n### 🧠 Feature Engineering\r\n- **Time-based features** (seasonality, weekday/weekend patterns)\r\n- **Lagged variables** (previous month spending for prediction)\r\n- **Anomaly detection** (travel months with 2x normal spending)\r\n- **Transaction patterns** (frequency, average amounts, volatility)\r\n\r\n### 🎯 Machine Learning\r\n- **Model comparison** (Linear, Ridge, Random Forest regression)\r\n- **Cross-validation** for robust performance evaluation\r\n- **Feature importance analysis** (avg transaction amount most predictive)\r\n- **Future predictions** (3-month spending forecasts)\r\n\r\n### 📊 Key Insights Discovered\r\n1. **Seasonal spending patterns** - October peak ($10K+ for Japan trip)\r\n2. **Restaurant spending dominance** - 91 transactions, $2,598 total\r\n3. **Predictable baseline** - Normal months: $3K-$6K range\r\n4. **Weekend spending** differs significantly from weekdays\r\n5. **Transaction frequency** correlates strongly with total spending\r\n\r\n## 💼 Business Value \u0026 Applications\r\n\r\n### Immediate Applications\r\n- **Budget forecasting** for upcoming months\r\n- **Spending anomaly detection** for unusual patterns\r\n- **Category optimization** for expense reduction\r\n- **Seasonal planning** for high-spending periods\r\n\r\n### Technical Skills Demonstrated\r\n- **End-to-end data science pipeline** development\r\n- **Real-world data integration** and cleaning\r\n- **Advanced feature engineering** techniques\r\n- **Machine learning model selection** and evaluation\r\n- **Interactive visualization** and dashboard creation\r\n- **Business insight generation** from technical analysis\r\n\r\n## 📧 Contact\r\n\r\n**Tyler Nguyen** - MIS Student \u0026 Data Analyst Enthusiast\r\n\r\n- 📧 Email: work.tylernguyen@gmail.com\r\n- 💼 LinkedIn: [linkedin.com/in/nguyen-tyler](https://www.linkedin.com/in/nguyen-tyler/)\r\n- 📱 GitHub: [@tillscode](https://github.com/tillscode)\r\n\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftillscode%2Fpersonal-finance-ml-analysis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftillscode%2Fpersonal-finance-ml-analysis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftillscode%2Fpersonal-finance-ml-analysis/lists"}