{"id":26556890,"url":"https://github.com/lordmitrii/budget-manager","last_synced_at":"2026-05-10T09:49:51.471Z","repository":{"id":213708523,"uuid":"718063298","full_name":"lordmitrii/budget-manager","owner":"lordmitrii","description":"This is a budget manager app that allows you to visualize your budget and to save it in database","archived":false,"fork":false,"pushed_at":"2024-03-06T11:51:05.000Z","size":95,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-10-19T01:01:20.007Z","etag":null,"topics":["matplotlib","pandas","python","seaborn","sql"],"latest_commit_sha":null,"homepage":"","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/lordmitrii.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}},"created_at":"2023-11-13T09:51:11.000Z","updated_at":"2024-09-28T09:02:28.000Z","dependencies_parsed_at":null,"dependency_job_id":"c6fa9355-6c25-4446-9c6e-dd9e83cf1232","html_url":"https://github.com/lordmitrii/budget-manager","commit_stats":null,"previous_names":["inskyeee/budget_manager","inskyeee/budget-manager","lordmitrii/budget-manager"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lordmitrii%2Fbudget-manager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lordmitrii%2Fbudget-manager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lordmitrii%2Fbudget-manager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lordmitrii%2Fbudget-manager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lordmitrii","download_url":"https://codeload.github.com/lordmitrii/budget-manager/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244952312,"owners_count":20537464,"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","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":["matplotlib","pandas","python","seaborn","sql"],"created_at":"2025-03-22T11:35:22.384Z","updated_at":"2026-05-10T09:49:46.448Z","avatar_url":"https://github.com/lordmitrii.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Budget Manager\n\nA Python-based budget management tool to categorize and visualize financial transactions. This project uses SQLite for database management and seaborn/matplotlib for data visualization.\n\n## Project Structure\n\n```plaintext\nbudget-manager/\n├── bank_statement_example.xls    # Example bank statement in Excel format\n├── categorization.py             # Script for categorizing transactions\n├── data.db                       # SQLite database for storing transaction data\n├── graph.png                     # Output visualization of the budget data\n├── input.py                      # Script for reading and inserting data into the database\n├── logger.log                    # Log file for tracking application logs\n└── visual.py                     # Script for visualizing budget data\n```\n\n\n### categorization.py\n\nScript for automatically categorizing financial transactions based on predefined keywords and user input. It uses SQLite for database operations and includes logging for tracking categorization activities.\n\n### input.py\n\nA utility script to read transaction data from an Excel file and insert it into the SQLite database. It handles data formatting and error logging.\n\n### visual.py\n\nGenerates visual representations of financial data using seaborn and matplotlib. It provides insights into spending patterns by category and time.\n\n## Installation and Usage\n\n1. Clone the repository to your local machine.\n2. Install the required libraries using `pip install -r requirements.txt`.\n3. Run `input.py` to load your financial data into the database.\n4. Execute `categorization.py` to categorize your transactions.\n5. Use `visual.py` to generate visual insights into your spending.\n\n## Features\n\n- **Automated Categorization**: Automatically categorize transactions based on predefined keywords. Allows manual categorization for unclassified transactions.\n- **Data Import**: Easily import transaction data from Excel files into a SQLite database for processing and analysis.\n- **Interactive Visualizations**: Generate insightful visualizations of spending patterns, including categorization and time-based spending trends, using seaborn and matplotlib.\n- **Customizable Categories**: Flexibility to define and modify transaction categories and associated keywords.\n- **Transaction Logging**: Comprehensive logging system to track the process of transaction categorization and errors.\n- **User Input for Categorization**: Interactive user prompts to categorize transactions that cannot be auto-categorized.\n \n## Contributing\n\nContributions to enhance the functionality or efficiency of the Budget Manager are welcome. Feel free to fork the repository and submit pull requests.\n\n## License\n\nThis project is open-sourced under the MIT License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flordmitrii%2Fbudget-manager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flordmitrii%2Fbudget-manager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flordmitrii%2Fbudget-manager/lists"}