{"id":30040194,"url":"https://github.com/neuraladitya/moneymind","last_synced_at":"2025-08-07T01:57:29.520Z","repository":{"id":307858477,"uuid":"1030916205","full_name":"NeuralAditya/MoneyMind","owner":"NeuralAditya","description":"💸 MoneyMind is a smart personal finance assistant built with Streamlit and Plotly. It provides personalized financial strategies, smart budgeting alerts, actionable savings plans, and intuitive visualizations to help users take full control of their money.","archived":false,"fork":false,"pushed_at":"2025-08-02T16:37:42.000Z","size":603,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-02T17:42:35.257Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NeuralAditya.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"license.txt","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-08-02T15:54:45.000Z","updated_at":"2025-08-02T16:37:45.000Z","dependencies_parsed_at":"2025-08-02T17:53:33.099Z","dependency_job_id":null,"html_url":"https://github.com/NeuralAditya/MoneyMind","commit_stats":null,"previous_names":["neuraladitya/moneymind"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/NeuralAditya/MoneyMind","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NeuralAditya%2FMoneyMind","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NeuralAditya%2FMoneyMind/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NeuralAditya%2FMoneyMind/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NeuralAditya%2FMoneyMind/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NeuralAditya","download_url":"https://codeload.github.com/NeuralAditya/MoneyMind/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NeuralAditya%2FMoneyMind/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269185774,"owners_count":24374634,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-06T02:00:09.910Z","response_time":99,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2025-08-07T01:57:08.648Z","updated_at":"2025-08-07T01:57:29.494Z","avatar_url":"https://github.com/NeuralAditya.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 💸 MoneyMind — Your Smart Financial Assistant\n\n![Python](https://img.shields.io/badge/Python-3776AB?style=for-the-badge\u0026logo=python\u0026logoColor=white)\n![Streamlit](https://img.shields.io/badge/Streamlit-FF4B4B?style=for-the-badge\u0026logo=streamlit\u0026logoColor=white)\n![NumPy](https://img.shields.io/badge/NumPy-013243?style=for-the-badge\u0026logo=numpy\u0026logoColor=white)\n![Matplotlib](https://img.shields.io/badge/Matplotlib-11557C?style=for-the-badge\u0026logo=plotly\u0026logoColor=white)\n![Plotly](https://img.shields.io/badge/Plotly-1E88E5?style=for-the-badge\u0026logo=plotly\u0026logoColor=white)\n![MIT License](https://img.shields.io/badge/License-MIT-green.svg?style=for-the-badge)\n\n---\n\n## 🚀 Overview\n\nMoneyMind is a powerful, AI-enhanced Streamlit web application that helps individuals take full control of their personal finances. With **personalized strategies**, **smart alerts**, and **intuitive visualizations**, you’ll gain clarity, control, and confidence over your financial journey.\n\n## 🖼️ UI Preview\n\n![App Screenshot](static/ui_screenshot.png)\n\n## 🎯 Analysis Output Screenshot\n\n![Prediction Result](static/prediction_screenshot.png)\n\n---\n\n## 🧩 Features\n\n### ✅ Personalized Financial Intelligence\n- **Advanced Recommendations Engine**: Tailored advice based on your income, spending habits, and goals.\n- **Category-Specific Advice**: Get insights for Food, Transportation, Entertainment, and more.\n\n### 📉 Expense Reduction Strategies\n- **Step-by-step Plans**: Learn exactly where and how to reduce expenses below your income level.\n- **8 General + Personalized Tips**: From bulk buying to subscription cuts, tailored to your lifestyle.\n\n### ⚡ Budget Control \u0026 Alerts\n- **Weekly and Monthly Limits**: Set smart budget limits per category.\n- **Emergency Overspending Alerts**: Be notified before your spending spirals.\n\n### 📋 30-Day Action Plan\n- A guided month-long plan to improve your financial situation, gradually and effectively.\n\n### 🎯 Savings Target Visualization\n- **Set \u0026 Track Your Savings Goal**: Visual progress bar toward a 20% savings target or custom goals.\n\n### 💡 Payment Optimization\n- Recommendations on the best payment methods and tools to track your expenses better.\n\n---\n\n## 📊 Technologies Used\n\nPython\n\nStreamlit\n\nPandas / NumPy\n\nMatplotlib / Plotly\n\nCustom rule-based recommendation engine\n\n---\n\n## 🗂️ Project Structure\n\n```\nMoneyMind/\n│\n├── app.py                   # Main Streamlit app\n├── data_processor.py        # Handles all data loading, cleaning, and transformations\n├── visualizations.py        # Contains chart and graph rendering logic\n├── .streamlit/              # Streamlit config directory\n├── attached_assets/         # Static assets like images or CSVs\n├── pyproject.toml           # Python dependencies and build metadata\n```\n\n---\n\n## 🛠️ How to Run\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/yourusername/MoneyMind.git\n   cd MoneyMind\n   ```\n\n2. Create a virtual environment (optional but recommended):\n   ```bash\n   python -m venv venv\n    .\\venv\\Scripts\\activate\n   ```\n\n3. Install dependencies:\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n4. Run the app:\n   ```bash\n   streamlit run app.py\n   ```\n\n5. If you face issues with 0.0.0.0, use:\n   ```\n   streamlit run app.py --server.address=localhost --server.port=8501\n   ```\n---\n## 📌 Future Improvements\n\nLogin \u0026 user authentication\n\nCloud-based user data storage\n\nCross-platform budgeting sync (Google Sheets/Excel export)\n\nExpense receipt scanner with OCR\n\n---\n\n## 📘 License\n\nThis project is licensed under the MIT License – see the [LICENSE](/license.txt) file for details.\n\n---\n\n## 🙌 Credits\n\nMade with ❤️ by [Aditya Arora](https://www.linkedin.com/in/NeuralAditya)  \n\u0026copy; 2025 Aditya Arora. All rights reserved.\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fneuraladitya%2Fmoneymind","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fneuraladitya%2Fmoneymind","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fneuraladitya%2Fmoneymind/lists"}