{"id":51186226,"url":"https://github.com/vevdokimovm/finance-telegram-bot","last_synced_at":"2026-06-27T10:03:11.480Z","repository":{"id":273080521,"uuid":"915724977","full_name":"vevdokimovm/finance-telegram-bot","owner":"vevdokimovm","description":"Telegram bot for tracking personal income and expenses with per-user SQLite storage","archived":false,"fork":false,"pushed_at":"2026-04-20T20:30:27.000Z","size":3,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-20T22:32:13.988Z","etag":null,"topics":["aiogram","finance","python","sqlite","telegram-bot"],"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/vevdokimovm.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-01-12T16:34:30.000Z","updated_at":"2026-04-20T20:43:45.000Z","dependencies_parsed_at":"2025-01-18T15:08:14.549Z","dependency_job_id":"6dd19891-f890-471a-83a7-f27662afe27e","html_url":"https://github.com/vevdokimovm/finance-telegram-bot","commit_stats":null,"previous_names":["vevdokimovm/tg-bot-for-finances","vevdokimovm/finance-telegram-bot"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/vevdokimovm/finance-telegram-bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vevdokimovm%2Ffinance-telegram-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vevdokimovm%2Ffinance-telegram-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vevdokimovm%2Ffinance-telegram-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vevdokimovm%2Ffinance-telegram-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vevdokimovm","download_url":"https://codeload.github.com/vevdokimovm/finance-telegram-bot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vevdokimovm%2Ffinance-telegram-bot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34848945,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-27T02:00:06.362Z","response_time":126,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","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":["aiogram","finance","python","sqlite","telegram-bot"],"created_at":"2026-06-27T10:03:10.878Z","updated_at":"2026-06-27T10:03:11.474Z","avatar_url":"https://github.com/vevdokimovm.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TG-bot-for-finances\n\nA Telegram bot for tracking personal income and expenses, built with Python and aiogram 3.\n\n## Features\n\n- Add income records with `/income \u003camount\u003e`\n- Add expense records with `/expense \u003camount\u003e`\n- View current balance with `/summary`\n- Per-user data isolation via Telegram user ID\n- Persistent storage using SQLite\n\n## Tech Stack\n\n- Python 3.10+\n- [aiogram 3](https://docs.aiogram.dev/) — async Telegram Bot API framework\n- SQLite — local database for transaction storage\n\n## Getting Started\n\n### Prerequisites\n\n- Python 3.10 or higher\n- A Telegram bot token from [@BotFather](https://t.me/BotFather)\n\n### Installation\n\n```bash\ngit clone https://github.com/vevdokimovm/TG-bot-for-finances.git\ncd TG-bot-for-finances\npip install -r requirements.txt\n```\n\n### Configuration\n\nOpen `bot_with_database.py` and replace `\u003cTOKEN\u003e` with your Telegram bot token:\n\n```python\nTOKEN = \"your_telegram_bot_token_here\"\n```\n\n### Run\n\n```bash\npython bot_with_database.py\n```\n\n## Bot Commands\n\n| Command | Description |\n|---|---|\n| `/start` | Welcome message and usage instructions |\n| `/income \u003camount\u003e` | Add an income record (e.g. `/income 5000`) |\n| `/expense \u003camount\u003e` | Add an expense record (e.g. `/expense 1200`) |\n| `/summary` | Show current balance |\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvevdokimovm%2Ffinance-telegram-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvevdokimovm%2Ffinance-telegram-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvevdokimovm%2Ffinance-telegram-bot/lists"}