{"id":22340623,"url":"https://github.com/casidiablo/lonchera","last_synced_at":"2025-07-21T16:03:41.145Z","repository":{"id":263557417,"uuid":"890745034","full_name":"casidiablo/lonchera","owner":"casidiablo","description":"Lunch Money Telegram bot","archived":false,"fork":false,"pushed_at":"2025-06-24T14:41:25.000Z","size":33230,"stargazers_count":21,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-15T01:37:11.764Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/casidiablo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-11-19T05:24:24.000Z","updated_at":"2025-06-24T14:41:31.000Z","dependencies_parsed_at":"2025-02-15T00:22:34.358Z","dependency_job_id":"5e9aaacf-4660-4d37-9efa-1e94e587d798","html_url":"https://github.com/casidiablo/lonchera","commit_stats":null,"previous_names":["casidiablo/lonchera"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/casidiablo/lonchera","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/casidiablo%2Flonchera","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/casidiablo%2Flonchera/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/casidiablo%2Flonchera/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/casidiablo%2Flonchera/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/casidiablo","download_url":"https://codeload.github.com/casidiablo/lonchera/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/casidiablo%2Flonchera/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266332347,"owners_count":23912660,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-21T11:47:31.412Z","response_time":64,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-04T07:12:22.160Z","updated_at":"2025-07-21T16:03:41.136Z","avatar_url":"https://github.com/casidiablo.png","language":"Python","funding_links":[],"categories":["Notifiers \u0026 Bots"],"sub_categories":["Bookmarklets"],"readme":"# 🥡 Lonchera\n\n[Lonchera is a Telegram bot](https://t.me/LunchMoneyAppBot) that seamlessly integrates with the\n[Lunch Money](https://lunchmoney.app/) personal finance application, empowering users to\neffortlessly manage their financial transactions right from Telegram.\n\n# 🔍 Transaction Monitoring\n- Periodically checks for new transactions and sends notifications to the user\n- Allows users to manually request a list of recent transactions\n\n![img1](media/main.png)\n\n# 🏷️ Transaction Management\nFor each transaction, users can:\n- Change the category\n- Add tags\n- Add notes\n- View Plaid details (if available)\n- Mark the transaction as reviewed (or unreviewed)\n- Change the payee's name\n\n![video1](media/1.gif)\n\n# 💸 Manual Transactions\n\n- Enables users to manually add transactions for accounts not managed by Plaid\n\nThis is very useful when tracking cash or other kinds of accounts.\n\n![video2](media/2.gif)\n\n# 📊 Budget Tracking\n\n- Displays the current state of the user's budget for the current month\n\n![video3](media/3.gif)\n\n# 🤖 AI-Powered Transaction Categorization\n\n- Leverage the [DeepInfra API](https://deepinfra.com/) to automatically categorize transactions using AI\n- This feature helps in accurately categorizing expenses without manual intervention\n\n![ai_categorization](media/ai_categorization.png)\n\n# Show balances\n\n- It can also show you the balances of all your accounts at a point in time\n\n![balances](media/balances.png)\n\n# ⚙️ Customizable Settings\n- Change the polling interval for new transactions\n- Toggle auto-marking of transactions as reviewed\n- Manage the Lunch Money API token\n\n![video4](media/4.gif)\n\n# 🚀 Getting Started\n1. Clone the repository\n2. Set up your Telegram bot token and Lunch Money API token\n3. Build and run the Docker container using the provided scripts\n  * Make sure to provide a local .env file with TELEGRAM_BOT_TOKEN=xxxx with the API of your own telegram bot\n\n# 📚 Self-Hosting Guide\nFor detailed instructions on how to run your own instance of the bot, please refer to the [SELFHOST.md](SELFHOST.md) file.\n\n## Note:\n\nThere is a publicly available instance of the bot that I am currently using myself:\n\nhttps://t.me/LunchMoneyAppBot\n\nHowever, please consider the following before using it:\n- I run this instance without any uptime or security guarantees.\n- I cannot guarantee the safety of your data.\n- Use this instance at your own risk.\n\nIf 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.\n\nThe 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.\n\n# 📄 License\nThis project is licensed under the [MIT License](LICENSE.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcasidiablo%2Flonchera","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcasidiablo%2Flonchera","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcasidiablo%2Flonchera/lists"}