cash-tracker-bot

A Telegram bot for tracking and managing cash flow. It automatically logs financial data and transactions into a Google Sheet and generates custom exports using OpenAI APIs.

Examples

• Log Expenses: You can tell the bot things like "Today I spent 5,00 € at the bar and 2,00 € for the bus ticket," and it will record these transactions on Google Sheet for you.
• Generate Reports: You can request reports with commands like "Give me an export of all expenses for September by {category}" and the bot will generate the requested data.

Getting Started

Configuration

• Activate Google Sheet API
• Activate OpenAI API
• Create Telegram bot and set token on .env

Installation

1. Clone the repo

   git clone https://github.com/LucaMino/cash-tracker-bot.git

2. Build container

   docker-compose up -d --build

3. Create .env from .env.example

4. Update settings.json (Change categories, payment methods...)

5. Create Google sheet, rename sheet_name and setup it using command /build_sheet

Usage

• Possibility to set lang using /set_lang it or /set_lang en (Change default on settings.json)
• Possibility to customize OpenAi prompt on OpenAIService.py
• Possibility to enable database storage on settings.json

License

Distributed under the MIT License. See LICENSE.txt for more information.