Lonchera is a Telegram bot that seamlessly integrates with the Lunch Money personal finance application, empowering users to effortlessly manage their financial transactions right from Telegram.
- Periodically checks for new transactions and sends notifications to the user
- Allows users to manually request a list of recent transactions
For each transaction, users can:
- Change the category
- Add tags
- Add notes
- View Plaid details (if available)
- Mark the transaction as reviewed (or unreviewed)
- Change the payee's name
- Enables users to manually add transactions for accounts not managed by Plaid
This is very useful when tracking cash or other kinds of accounts.
- Displays the current state of the user's budget for the current month
- Leverage the DeepInfra API to automatically categorize transactions using AI
- This feature helps in accurately categorizing expenses without manual intervention
- It can also show you the balances of all your accounts at a point in time
- Change the polling interval for new transactions
- Toggle auto-marking of transactions as reviewed
- Manage the Lunch Money API token
- Clone the repository
- Set up your Telegram bot token and Lunch Money API token
- Build and run the Docker container using the provided scripts
- Make sure to provide a local .env file with TELEGRAM_BOT_TOKEN=xxxx with the API of your own telegram bot
For detailed instructions on how to run your own instance of the bot, please refer to the SELFHOST.md file.
There is a publicly available instance of the bot that I am currently using myself:
However, please consider the following before using it:
- I run this instance without any uptime or security guarantees.
- I cannot guarantee the safety of your data.
- Use this instance at your own risk.
If you decide to use it, please be aware that while I promise not to look at or use your token, I cannot provide any assurances beyond my word.
The bot is designed to support multiple users, meaning the same bot can track transactions for different accounts, such as mine and my wife's, in their respective Telegram accounts.
This project is licensed under the MIT License.
🍱 Happy expense tracking! 🎉