Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dhruv282/expense-tracker
:credit_card::dollar:📈 Open-source web app for expense tracking and visualizing
https://github.com/dhruv282/expense-tracker
budget-tracker expense-manager expense-tracker expenses pandas plotly python streamlit streamlit-webapp
Last synced: 2 days ago
JSON representation
:credit_card::dollar:📈 Open-source web app for expense tracking and visualizing
- Host: GitHub
- URL: https://github.com/dhruv282/expense-tracker
- Owner: dhruv282
- License: mit
- Created: 2023-12-03T19:57:12.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-04-23T22:49:25.000Z (10 months ago)
- Last Synced: 2024-12-19T08:17:40.216Z (about 2 months ago)
- Topics: budget-tracker, expense-manager, expense-tracker, expenses, pandas, plotly, python, streamlit, streamlit-webapp
- Language: Python
- Homepage: https://expense-tracker-demo.streamlit.app
- Size: 169 KB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Expense Tracker
[](https://expense-tracker-demo.streamlit.app/)
Expense Tracker is an open-source expense tracking and visualization program developed using [Streamlit](https://streamlit.io/). The data is supplied by a user specified Google Sheet. Visualizations generated in this app are created using [Plotly](https://plotly.com/python/).
## Usage
A sample Google Sheet compatible with this application can be found here:
[Test Expense Tracker](https://docs.google.com/spreadsheets/d/1QGq30uszyxQzAoARVy4pZE0LElwIuXXMbFc5g4ftjVk)
The connection to Google Sheets is powered by [gsheets-connection](https://github.com/streamlit/gsheets-connection). Follow instructions in the repo to connect the desired Google Sheet.
This application supports tracking for expense trackers that involve multiple individuals. Transaction owners can be specified as shown in the example file: [.streamlit/secrets.toml](.streamlit/secrets.toml).
### Running locally
Dependencies can be installed using the following command:
```shell
$ pip install -r requirements.txt
```
Run the following command to start a local instance of this using the Streamlit engine:
```shell
$ streamlit run app.py
```
### Configuration
A sample [secrets.toml](.streamlit/secrets.toml) file using all currently available configuration options has been supplied in the `.streamlit` directory. You can learn more about Streamlit configuration options via the [Streamlit docs](https://docs.streamlit.io/library/advanced-features/configuration).
Use the `secrets.toml` to add the credentials for your own Google Sheet.
### Deployment
Follow the official [Streamlit deployment guide](https://docs.streamlit.io/streamlit-community-cloud/deploy-your-app) to host this on the Streamlit Community Cloud.
A Docker image can also be built and deployed for users who prefer alternate hosting solutions. The official Docker installation guide can be found [here](https://docs.docker.com/installation/). Run the following commands to build and run the Docker image.
```shell
$ docker build -t expense-tracker .
$ docker run -p 8501:8501 expense-tracker
```
## License
Expense Tracker is open-source software released under the [MIT License](https://opensource.org/licenses/MIT). You are free to modify and distribute the application under the terms of this license. See the [`LICENSE`](./LICENSE) file for more information.
Please note that this README file is subject to change as the application evolves. Refer to the latest version of this file in the repository for the most up-to-date information.