{"id":22891108,"url":"https://github.com/ChiefGyk3D/investment_tools","last_synced_at":"2025-08-12T00:31:32.818Z","repository":{"id":267078964,"uuid":"900209846","full_name":"ChiefGyk3D/investment_tools","owner":"ChiefGyk3D","description":"Repo of tools I created to help me budget and plan better","archived":false,"fork":false,"pushed_at":"2024-12-08T07:04:51.000Z","size":0,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-12-08T07:24:51.297Z","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/ChiefGyk3D.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2024-12-08T06:48:37.000Z","updated_at":"2024-12-08T07:04:55.000Z","dependencies_parsed_at":"2024-12-08T07:34:55.016Z","dependency_job_id":null,"html_url":"https://github.com/ChiefGyk3D/investment_tools","commit_stats":null,"previous_names":["chiefgyk3d/investment_tools"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ChiefGyk3D/investment_tools","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChiefGyk3D%2Finvestment_tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChiefGyk3D%2Finvestment_tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChiefGyk3D%2Finvestment_tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChiefGyk3D%2Finvestment_tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ChiefGyk3D","download_url":"https://codeload.github.com/ChiefGyk3D/investment_tools/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChiefGyk3D%2Finvestment_tools/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269980802,"owners_count":24507270,"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-11T02:00:10.019Z","response_time":75,"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":"2024-12-13T22:01:14.021Z","updated_at":"2025-08-12T00:31:32.803Z","avatar_url":"https://github.com/ChiefGyk3D.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# Investment and Financial Tools\n\nThis repository contains a collection of Python scripts designed to help with financial planning, analysis, and decision-making. Each script is tailored for a specific purpose, ranging from loan calculations to retirement planning.\n\n---\n\n## Tools\n\n### 1. **Auto Loan Calculator**  \n**File:** `auto_loan.py`  \nCalculate the monthly payment, total interest, and payoff schedule for an auto loan.  \n**Features:**  \n- Adjustable loan term and interest rate.  \n- Detailed amortization schedule.\n\n### 2. **Budget Planner**  \n**File:** `budget_planner.py`  \nAllocate income across spending categories and track actual spending against the budget.  \n**Features:**  \n- Visualizes spending vs. budget with pie and bar charts.  \n- Provides detailed breakdown and insights in Excel.\n\n### 3. **Compound Interest Calculator**  \n**File:** `compound_interest.py`  \nAnalyze compound interest growth with options for inflation adjustment and contribution increases.  \n**Features:**  \n- Flexible contribution frequencies (e.g., monthly, bi-weekly).  \n- Calculates real vs. nominal balance.  \n- Embedded graphs in Excel output.\n\n### 4. **Debt Payoff Planner**  \n**File:** `debt_payoff.py`  \nCompare the Snowball and Avalanche methods for paying off debts.  \n**Features:**  \n- Customizable payoff strategies.  \n- Detailed debt schedules with total interest comparisons.\n\n### 5. **Emergency Fund Calculator**  \n**File:** `emergency_fund.py`  \nTrack progress toward building an emergency fund.  \n**Features:**  \n- Supports multiple contribution frequencies.  \n- Calculates how long it will take to reach your goal.  \n- Visualizes savings growth.\n\n### 6. **Loan vs. Savings Comparison Tool**  \n**File:** `loan_savings_comparison.py`  \nCompare the costs and benefits of saving for an expense versus taking out a loan.  \n**Features:**  \n- Adjustable timeframes for savings and loan terms.  \n- Inflation-adjusted savings targets.  \n- Graphs comparing loan costs to savings growth.\n\n### 7. **Mortgage Calculator**  \n**File:** `mortgage.py`  \nCalculate monthly payments, including property taxes, insurance, and PMI, for a mortgage.  \n**Features:**  \n- Optional extra payments for faster payoff.  \n- Detailed amortization schedules.  \n- Visualizes interest vs. principal over time.\n\n### 8. **Personal Loan Calculator**  \n**File:** `personal_loan.py`  \nAnalyze monthly payments, total interest, and payoff schedules for personal loans.  \n**Features:**  \n- Flexible loan term and interest rate.  \n- Generates Excel breakdowns.\n\n### 9. **Retirement Savings Planner**  \n**File:** `retirement.py`  \nPlan how much to save to reach your retirement goals.  \n**Features:**  \n- Accounts for inflation and annual contribution increases.  \n- Breaks down savings progress by contribution frequency.  \n- Generates graphs and Excel summaries.\n\n### 10. **Savings Goal Planner**  \n**File:** `savings_goal.py`  \nDetermine the contributions needed to achieve a specific financial goal by a set date.  \n**Features:**  \n- Flexible contribution frequencies.  \n- Inflation-adjusted goals.  \n- Provides a detailed progress report in Excel.\n\n### 11. **Stock Growth Calculator**  \n**File:** `stock_growth.py`  \nCalculate stock growth with reinvested dividends and periodic contributions.  \n**Features:**  \n- Supports various contribution frequencies.  \n- Visualizes investment growth over time.  \n- Detailed breakdowns in Excel.\n\n### 12. **Long Weekend Planner**  \n**File:** `long_weekend.py`  \nIdentify U.S. federal holidays and plan extended weekends by taking adjacent days off.  \n**Features:**  \n- Calculates dates for U.S. federal holidays.  \n- Suggests which days to take off to create long weekends.  \n- Accounts for holidays that fall mid-week, on Mondays, or Fridays.\n\n---\n\n## Requirements\n\n- **Python 3.10 or later**\n- **Dependencies**:\n  - `pandas`\n  - `matplotlib`\n  - `openpyxl`\n\nInstall dependencies using:\n```\npip install -r requirements.txt\n```\n\n---\n\n## Usage\n\n1. Clone the repository:\n```\ngit clone https://github.com/chiefgyk3d/investment_tools.git\ncd investment_tools\n```\n\n2. Install dependencies:\n```\npip install -r requirements.txt\n```\n\n3. Run any script from the command line. For example, to calculate compound interest:\n```\npython3 compound_interest.py\n```\n\n4. Follow the prompts to input your data. Each script will guide you step by step through the required inputs.\n\n5. The results will be saved in an Excel file in the current directory. The file will include:\n   - Detailed breakdowns of calculations.\n   - Embedded graphs for visualization.\n\n---\n\n## Example\n\n**Using the Budget Planner:**\n\nRun the script:\n```\npython3 budget_planner.py\n```\n\nFollow the prompts:\n- Enter your monthly income.\n- Specify budget categories and amounts (e.g., \"Housing: 1500\").\n- Enter your actual spending in each category.\n- Provide a base name for the output files (e.g., \"budget_report\").\n\nThe output will include:\n- An Excel file (`budget_report.xlsx`) with detailed budget vs. actual comparisons.\n- Charts embedded in the file for easy visualization.\n\n---\n\n## Contributions\n\nFeel free to contribute by submitting issues or pull requests. Suggestions for new tools or features are always welcome!\n\n---\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n\n---\n\n## Author\n\n**ChiefGyk3D**  \nFor more of my work, visit [My GitHub Profile](https://github.com/chiefgyk3d).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FChiefGyk3D%2Finvestment_tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FChiefGyk3D%2Finvestment_tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FChiefGyk3D%2Finvestment_tools/lists"}