https://github.com/lincolnlewin8/TG-Financial-SheetAPI-Bot
A comprehensive Telegram bot designed for managing financial accounting, featuring seamless integration with the Google Sheets API to automate data entry, tracking, and reporting for enhanced efficiency and accuracy.
https://github.com/lincolnlewin8/TG-Financial-SheetAPI-Bot
financial-data google-sheets-api python telegram-bot
Last synced: 3 months ago
JSON representation
A comprehensive Telegram bot designed for managing financial accounting, featuring seamless integration with the Google Sheets API to automate data entry, tracking, and reporting for enhanced efficiency and accuracy.
- Host: GitHub
- URL: https://github.com/lincolnlewin8/TG-Financial-SheetAPI-Bot
- Owner: lincolnlewin8
- Created: 2024-09-19T13:57:52.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-01-17T21:13:05.000Z (12 months ago)
- Last Synced: 2025-07-06T19:46:22.573Z (6 months ago)
- Topics: financial-data, google-sheets-api, python, telegram-bot
- Language: Python
- Homepage:
- Size: 21.5 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Telegram Financial Bot (Integrated Google Sheet APIs)
Telegram bot for tracking personal expenses and budgeting, [video with explanations of the code and description](https://www.youtube.com/watch?v=Kh16iosOTIQ).
In the environment variables, you need to specify the bot's API token, as well as the proxy address and login-password to it.
## Contact me
Telegram: [@dwlee918](https://t.me/@dwlee918)
X: [@dwlee918](https://x.com.me/@dwlee918)
## How to Run
`TELEGRAM_API_TOKEN` — API Bot Token
`TELEGRAM_PROXY_URL` — Proxy Server URL
`TELEGRAM_PROXY_LOGIN` — proxy server login
`TELEGRAM_PROXY_PASSWORD` — proxy server password
`TELEGRAM_ACCESS_ID` — Telegram account ID from which messages will be received (messages from other accounts are ignored)
Usage with Docker is shown below. Pre-fill the ENV variables specified above in the Dockerfile, and also specify the local directory with the project instead of `local_project_path` in the run command. The SQLite database will be located in the project folder `db/finance.db`.
```
docker build -t tgfinance ./
docker run -d --name tg -v /local_project_path/db:/home/db tgfinance
```
To enter a running container:
```
docker exec -ti tg bash
```
Login to SQL shell in container:
```
docker exec -ti tg bash
sqlite3 /home/db/finance.db
```