{"id":36858998,"url":"https://github.com/aattwwss/telegram-expense-bot","last_synced_at":"2026-01-12T14:48:28.333Z","repository":{"id":63619316,"uuid":"568923223","full_name":"aattwwss/telegram-expense-bot","owner":"aattwwss","description":"An open source telegram bot to track your expenses.","archived":false,"fork":false,"pushed_at":"2024-06-01T04:54:43.000Z","size":245,"stargazers_count":2,"open_issues_count":6,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-06-01T05:46:07.894Z","etag":null,"topics":["golang","telegram"],"latest_commit_sha":null,"homepage":"","language":"Go","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/aattwwss.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2022-11-21T17:44:08.000Z","updated_at":"2024-06-01T04:54:46.000Z","dependencies_parsed_at":"2024-03-11T11:52:24.545Z","dependency_job_id":null,"html_url":"https://github.com/aattwwss/telegram-expense-bot","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/aattwwss/telegram-expense-bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aattwwss%2Ftelegram-expense-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aattwwss%2Ftelegram-expense-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aattwwss%2Ftelegram-expense-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aattwwss%2Ftelegram-expense-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aattwwss","download_url":"https://codeload.github.com/aattwwss/telegram-expense-bot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aattwwss%2Ftelegram-expense-bot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28340410,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-12T12:22:26.515Z","status":"ssl_error","status_checked_at":"2026-01-12T12:22:10.856Z","response_time":98,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["golang","telegram"],"created_at":"2026-01-12T14:48:26.305Z","updated_at":"2026-01-12T14:48:28.300Z","avatar_url":"https://github.com/aattwwss.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# telegram-expense-bot\n\n# Add To Telegram\nAdd @MyXpensesBot on telegram.\n\n# How To Self Host\n\n## Prerequisite\n\n1. Create a telegram bot using [BotFather](https://telegram.me/botfather).\n2. Optional. If using webhook, register the domain of the server you are hosting this bot on.\n```bash\ncurl https://api.telegram.org/bot=\u003ctoken\u003e/setWebhook?url=\u003cdomain\u003e\n```\n2. A postgres database and init the database with the [init.sql](https://github.com/aattwwss/telegram-expense-bot/blob/main/scripts/init.sql).\n\n## Run the bot\n1. Clone the repo\n```bash\ngit clone https://github.com/aattwwss/telegram-expense-bot\n```\n2. Create local env file\n```bash\ncd telegram-expense-bot\ntouch .env.local\n```\n3. Edit and save local env file with your own configurations\n```bash\nvim .env.local\n```\n4. Run the server and bot\n```bash\ngo run main.go\n```\n\nWithout docker\n```bash\nexport .env.local\ngo run main.go\n```\nWith docker\n```bash\n./start.sh\n```\n\n# Privacy\nThis bot does not store any personal information other than your telegram user id.\n\n# Features\n- [x] Sign up as a new user from new chat with bot\n- [x] Add a transaction as current user\n- [x] Selection of category when adding transaction\n- [x] Delete last entry by using /undo command\n- [X] Calculate transaction per month\n- [x] Triggered from /stats, default fetch from current month.\n- [x] /stats [month] [year]\n- [x] View transactions by using /list command\n- [ ] Allow user to change timezone. (default Asia/Singapore)\n- [ ] Allow user to change currency. (default SGD)\n- [x] Export transactions to file\n\n# Dev / Infra \n- [ ] Fix image deployed on github container repository not reachable by telegram server\n\n# Optimisation \n- [x] Don't return cancel button when next and prev button is not returned. (for transaction list)\n- [x] Show page number in transaction list\n- [ ] Delete message context stored in database after a period of time\n- [ ] Store data of inline keyboard somewhere else to bypass the 64 bytes size limit\n\n# Misc\n- [x] Consolidate SQL to the latest schema\n- [x] Prepare docker compose for self hosted guide\n- [x] Prepare self hosted guide\n\n# Support\nIf you have any questions or problems, email me at telegram.expense.bot@gmail.com\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faattwwss%2Ftelegram-expense-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faattwwss%2Ftelegram-expense-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faattwwss%2Ftelegram-expense-bot/lists"}