{"id":29861221,"url":"https://github.com/atharvbyadav/expensemate","last_synced_at":"2026-04-28T21:34:08.154Z","repository":{"id":285194824,"uuid":"957343928","full_name":"atharvbyadav/ExpenseMate","owner":"atharvbyadav","description":"A simple, lightweight personal finance tracker built with Streamlit and SQLite. Log expenses, visualize spending habits, manage budgets, and download reports – all through an interactive web interface.","archived":false,"fork":false,"pushed_at":"2025-06-25T18:24:44.000Z","size":28,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-24T06:55:54.867Z","etag":null,"topics":["budgeting","data-analysis","data-visualization","expense-tracker","finance-app","open-source","pandas","personal-finance","plotly","python","sqlite","streamlit","streamlit-webapp"],"latest_commit_sha":null,"homepage":"https://expensemate.streamlit.app/","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/atharvbyadav.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,"zenodo":null}},"created_at":"2025-03-30T05:54:23.000Z","updated_at":"2025-07-13T13:17:41.000Z","dependencies_parsed_at":"2025-06-25T19:23:12.184Z","dependency_job_id":"0468d13b-4222-4a5e-bfcd-4b42cbc77895","html_url":"https://github.com/atharvbyadav/ExpenseMate","commit_stats":null,"previous_names":["atharvbyadav/expensemate"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/atharvbyadav/ExpenseMate","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atharvbyadav%2FExpenseMate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atharvbyadav%2FExpenseMate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atharvbyadav%2FExpenseMate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atharvbyadav%2FExpenseMate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/atharvbyadav","download_url":"https://codeload.github.com/atharvbyadav/ExpenseMate/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atharvbyadav%2FExpenseMate/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32400866,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-28T19:38:08.556Z","status":"ssl_error","status_checked_at":"2026-04-28T19:37:55.688Z","response_time":56,"last_error":"SSL_read: 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":["budgeting","data-analysis","data-visualization","expense-tracker","finance-app","open-source","pandas","personal-finance","plotly","python","sqlite","streamlit","streamlit-webapp"],"created_at":"2025-07-30T04:13:09.097Z","updated_at":"2026-04-28T21:34:08.139Z","avatar_url":"https://github.com/atharvbyadav.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ExpenseMate\r\n\r\n## Overview\r\n\r\nExpenseMate is a user-friendly personal finance tracker built using **Streamlit** and **SQLite**. It helps users monitor expenses, analyze spending habits and manage their monthly budget with interactive visualizations.\r\n\r\n🚀 **Live Demo**: [ExpenseMate](https://expensemate.streamlit.app/)\r\n\r\n🔗 **GitHub Repository**: [ExpenseMate GitHub](https://github.com/atharvbyadav/ExpenseMate)\r\n\r\n🌟 If you find this project useful, **please star the repository!** 🌟\r\n\r\n---\r\n\r\n## Features\r\n\r\n### ✅ Add Expenses\r\n\r\n- Select the **date** and **time** (12-hour format with AM/PM option).\r\n- Choose an expense **category** (Food, Rent, Transport, etc.).\r\n- Enter **description** and **amount**.\r\n- Store entries in an **SQLite database**.\r\n\r\n### ❌ Delete Expenses\r\n\r\n- Select any **recorded expense** to delete from the database.\r\n\r\n### 📊 View Expense Report\r\n\r\n- **View all expenses** in a table format.\r\n- **Pie chart visualization** of expenses by category.\r\n- **Line chart tracking** spending over time.\r\n- **Budget Summary** with total spent and remaining balance.\r\n- **Download expenses report** as a CSV file.\r\n\r\n---\r\n\r\n## Installation \u0026 Usage 🛠️\r\n\r\n### 🔹 Prerequisites\r\n\r\nEnsure you have **Python 3.x** installed on your system.\r\n\r\n### Step 1️⃣ - Clone the Repository\r\n\r\n```sh\r\ngit clone https://github.com/atharvbyadav/ExpenseMate.git\r\ncd ExpenseMate\r\n```\r\n\r\n### Step 2️⃣ - Set Up a Virtual Environment (Recommended)\r\n\r\nTo prevent package conflicts, create and activate a virtual environment:\r\n\r\n```sh\r\npython3 -m venv venv\r\nsource venv/bin/activate  # On Windows, use: venv\\Scripts\\activate\r\n```\r\n\r\n### Step 3️⃣ - Install Dependencies\r\n\r\nInstall required dependencies using the provided **requirements.txt** file:\r\n\r\n```sh\r\npip install -r requirements.txt\r\n```\r\n\r\n### Step 4️⃣ - Run the Application\r\n\r\n```sh\r\nstreamlit run ExpenseMate.py\r\n```\r\n\r\nThe application will open in your default web browser.\r\n\r\n---\r\n\r\n## Usage Guide\r\n\r\n### 🏠 Home Page\r\n\r\n- The **sidebar** provides navigation to different sections:\r\n  - **Add Expense**\r\n  - **View Report**\r\n  - **Delete Expense**\r\n- Set your **monthly budget** in the sidebar.\r\n\r\n### ➕ Adding an Expense\r\n\r\n1. Click **\"Add Expense\"**.\r\n2. Select **Date** and **Time (12-hour format)**.\r\n3. Choose an **expense category**.\r\n4. Enter **description** and **amount**.\r\n5. Click **\"Add Expense\"** to save.\r\n\r\n### ❌ Deleting an Expense\r\n\r\n1. Click **\"Delete Expense\"**.\r\n2. Select an expense from the dropdown.\r\n3. Click **\"Delete\"** to remove it.\r\n\r\n### 📊 Viewing Reports\r\n\r\n- Click **\"View Report\"**.\r\n- View **expense details, category breakdown and spending trends**.\r\n- **Download** the report as CSV.\r\n\r\n---\r\n\r\n## Technologies Used\r\n\r\n- **Streamlit** - Frontend UI framework\r\n- **SQLite** - Local database for storing expenses\r\n- **Pandas** - Data handling and processing\r\n- **Plotly** - Data visualization (Pie charts, Line graphs)\r\n\r\n---\r\n\r\n## License\r\n\r\nThis project is licensed under the **MIT License** - feel free to use and modify it!\r\n\r\n---\r\n\r\n## Future Enhancements\r\n\r\n🚀 **Planned Features**:\r\n\r\n- ✅ Advanced filtering and search for expenses\r\n- 📅 Generate monthly \u0026 yearly reports\r\n- 📱 Improve UI for mobile users\r\n- 🔔 Add notifications for budget alerts\r\n\r\n---\r\n\r\n## Contributing\r\n\r\nWant to improve ExpenseMate? Contributions are welcome! 🎉\r\n\r\nFork the repo, create a branch and submit a pull request.\r\n\r\n---\r\n\r\n## Contact\r\n\r\n💬 Feel free to reach out on GitHub or open an issue for suggestions and feedback!\r\n\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatharvbyadav%2Fexpensemate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fatharvbyadav%2Fexpensemate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatharvbyadav%2Fexpensemate/lists"}