Budget Bot

This Telegram Bot keeps track of your budget.

Features:

• date selection (currently set to today minus 8 days - adjustable)
• currency selection
• add a new currency -> values obtained automatically from https://exchangeratesapi.io/
• category selection (again easy to adjust)
• send all expanses - in a nice csv format -> easy to import elsewhere
• delete last entry
• clear all entries

The bot is running on my Raspberry Pi and can be found here

But it is also easy to build and deploy on your own server. See below.

Development

Setup

source setup-local-venv.sh

Deployment

Setup Environment

• Create a Telegram Bot using the BotFather
• Create a chat where the bot will send logs and errors
• Create an Exchange Rate Api key here
• Create a file env.json in the budget_csvs subdirectory with the developer_chat_id, the bot_token, and the currency_exchange_api

{
  "developer_chat_id": "<REPLACE WITH DEVELOPER CHAT ID>",
  "bot_token": "<REPLACE WITH BOT TOKEN>",
  "currency_exchange_api": "<REPLACE WITH EXCHANGE RATE API KEY>"
}

Build docker

Raspberry Pi

./docker-build-raspberry-pi.sh

Linux/Mac

./docker-build-linux.sh

Run docker

./docker-run.sh

Sources

• Using Exchange Rate Api key
• Inspired by https://github.com/python-telegram-bot/python-telegram-bot/wiki/InlineKeyboard-Example