{"id":19634727,"url":"https://github.com/lleballex/aiogram-template","last_synced_at":"2025-07-31T13:16:08.593Z","repository":{"id":160383275,"uuid":"592852947","full_name":"lleballex/aiogram-template","owner":"lleballex","description":"Template of aiogram telegram bot","archived":false,"fork":false,"pushed_at":"2023-02-09T15:11:53.000Z","size":7,"stargazers_count":7,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-28T13:29:02.177Z","etag":null,"topics":["aiogram","aiogram-bot-template","aiogram3","python","python-i18n","telegram-bot","template"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lleballex.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2023-01-24T17:17:26.000Z","updated_at":"2024-12-13T12:27:59.000Z","dependencies_parsed_at":"2023-05-25T11:00:33.981Z","dependency_job_id":null,"html_url":"https://github.com/lleballex/aiogram-template","commit_stats":null,"previous_names":[],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/lleballex/aiogram-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lleballex%2Faiogram-template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lleballex%2Faiogram-template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lleballex%2Faiogram-template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lleballex%2Faiogram-template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lleballex","download_url":"https://codeload.github.com/lleballex/aiogram-template/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lleballex%2Faiogram-template/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268045763,"owners_count":24186845,"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-31T02:00:08.723Z","response_time":66,"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","aiogram-bot-template","aiogram3","python","python-i18n","telegram-bot","template"],"created_at":"2024-11-11T12:22:28.596Z","updated_at":"2025-07-31T13:16:08.526Z","avatar_url":"https://github.com/lleballex.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ⚡ Aiogram bot template\r\n\r\nIt is a template you can use for creating telegram bot with aiogram 3. It supports internationalization\r\n\r\n### Tools:\r\n\r\n- 💪 Aiogram (v3)\r\n- 😄 i18n\r\n- 🤹🏽 Loguru\r\n\r\n## 🔥 Getting started\r\n\r\n### Requirements:\r\n\r\n- Python\r\n- Make\r\n\r\n### Installing\r\n\r\n###### For linux\r\n\r\n```bash\r\ngit clone git@github.com:lleballex/aiogram-template.git\r\ncd aiogram-template\r\npython3 -m venv env\r\n. env/bin/activate\r\npip install -r requirements.txt\r\n```\r\n\r\n###### For windows\r\n\r\n```bash\r\ngit clone git@github.com:lleballex/aiogram-template.git\r\ncd aiogram-template\r\npython -m venv env\r\nenv\\scripts\\activate\r\npip install -r requirements.txt\r\n```\r\n\r\n### Starting\r\n\r\n```bash\r\npython src/bot.py\r\n```\r\n\r\n## ✍ Adding handlers\r\n\r\nJust create new file in *src/handlers* folder or its subfolder\r\n\r\n#### Initialize router and use it to handle events:\r\n\r\n```python\r\nfrom aiogram import Router\r\nmy_router = Router()\r\n```\r\n\r\n#### Add created router to router list in *src/handlers/\\_\\_init\\_\\_.py*:\r\n\r\n```python\r\nfrom .my_file import my_router\r\nrouters = [my_router]\r\n```\r\n\r\n## 📖 Internationalization\r\n\r\nThis template uses i18n. So wrap your messages in `aiogram.utils.i18n.gettext` to make it translatable\\\r\nMore information you can find [here](https://docs.aiogram.dev/en/dev-3.x/utils/i18n.html#step-3-translate-texts)\r\n\r\n#### Extracting messages (creating .pot):\r\n\r\n```bash\r\nmake i18n-extract\r\n```\r\n\r\n#### Initializing a new language:\r\n\r\n```\r\nmkdir locales\r\npybabel init -i locales/messages.pot -d locales -D messages -l en\r\n```\r\n\r\n#### Compiling translations (.po -\u003e .mo):\r\n\r\n```bash\r\nmake i18n-compile\r\n```\r\n\r\n#### Updating translated messages (.po) with new extracted messages (.pot):\r\n\r\n```bash\r\nmake i18n-update\r\n```\r\n\r\n## 🙋🏽‍♂️ Contact me\r\n\r\n[\u003cimg width=\"30px\" title=\"lleballex | Telegram\" src=\"https://raw.githubusercontent.com/github/explore/main/topics/telegram/telegram.png\"\u003e](https://t.me/lleballex)\r\n[\u003cimg width=\"30px\" title=\"lleballex | VK\" src=\"https://raw.githubusercontent.com/github/explore/main/topics/vk/vk.png\"\u003e](https://vk.com/lleballex)\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flleballex%2Faiogram-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flleballex%2Faiogram-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flleballex%2Faiogram-template/lists"}