{"id":15298455,"url":"https://github.com/astronuttt/aiogram-template","last_synced_at":"2026-04-06T09:11:19.068Z","repository":{"id":130183094,"uuid":"389967133","full_name":"astronuttt/aiogram-template","owner":"astronuttt","description":"A bootstrap template for building Telegram bots with Aiogram","archived":false,"fork":false,"pushed_at":"2022-03-24T22:55:53.000Z","size":15,"stargazers_count":8,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-25T01:13:54.116Z","etag":null,"topics":["aiogram","telegram","telegram-bots","telegrambots","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/astronuttt.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}},"created_at":"2021-07-27T12:03:36.000Z","updated_at":"2025-01-07T12:35:56.000Z","dependencies_parsed_at":"2023-04-27T21:47:33.773Z","dependency_job_id":null,"html_url":"https://github.com/astronuttt/aiogram-template","commit_stats":null,"previous_names":["astronuttt/aiogram-template","sina-e/aiogram-template"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/astronuttt%2Faiogram-template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/astronuttt%2Faiogram-template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/astronuttt%2Faiogram-template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/astronuttt%2Faiogram-template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/astronuttt","download_url":"https://codeload.github.com/astronuttt/aiogram-template/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235633947,"owners_count":19021455,"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","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","telegram","telegram-bots","telegrambots","template"],"created_at":"2024-09-30T21:00:50.989Z","updated_at":"2025-10-07T13:30:19.638Z","avatar_url":"https://github.com/astronuttt.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# Aiogram Bot template\n\nstart developing your telegram bot right away!\n\nI built this project, so i could develop my bots faster.\n\nthis bot doesn't do anything useful but it's a template for building fully functional bots.\n\nit's an example implementation, you can do it however you like and change it to your liking!\n\nproject will be updated and new features will be added soon...\n\n#### some other templates for Aiogram that this project is inspired by them:\n\n- [aiogram-structured](https://github.com/amirho3inf/aiogram-structured)\n- [aiogram_bot_template](https://github.com/nacknime-official/aiogram_bot_template)\n- [bot](https://github.com/aiogram/bot)\n\n\n## Features\n\nthis template project uses:\n\n- [Aiogram](https://github.com/aiogram/aiogram/) (Telegram-Bot API Framework)\n- [Tortoise-ORM](https://github.com/tortoise/tortoise-orm) (Db ORM)\n- [Aerich](https://github.com/tortoise/aerich) (Database migrations)\n- [aiomysql](https://github.com/aio-libs/aiomysql) (MySql database driver for asyncio)\n- [aioredis](https://github.com/aio-libs/aioredis-py) (FSM and in memory db)\n\nDevelpment tools:  \n\n- [flake8](https://github.com/PyCQA/flake8) (Linter)\n- [Black](https://github.com/psf/black) (Formatter)\n- [aiohttp-autoreload](https://github.com/anti1869/aiohttp_autoreload) (Auto reload on saving files)\n\n\n## installation\n\n### local installation for Linux\n\nyou need git and python +3.7 installed in your system\n\nclone the repository:\n\nfirst Fork this project on your github account if you want.\n\nclone the repository: \n\nexample:\n\n`git clone https://github.com/sinaebrahimi1/aiogram-template.git`\n\nchange directory to project's direcotry:\n\n`cd aiogram-template`\n\ninstall `virtualenv` with pip if you don't have it:\n\n`pip install virtualenv`\n\ncreate a new virtualenv and enable it:\n\n`python -m virtualenv .venv`\n\n`source .venv/bin/activate`\n\nnow you need to install needed libraries:\n\n`pip install -r requirements.txt`\n\nnow you need MySql installed on your system(or in a docker container) and also redis.\n\nmake sure to install these two dependencies for your linux distro.\n\nyou can also use sqlite or postgresql or anything else that is supported by Tortoise-ORM.\n\nnow it's time to create `.env` file and enter your configuration:\n\n`mv .env.example .env`\n\nopen the `.env` file in your editor and complete the required variables and any other configuration you want based on `app/config.py` file.\n\n`PROXY_URL` is optional, it's useful if you live in a country that telegram is banned.\n\nI'ts done!\n\nnow you can test it:\n\nfirst make `bot.py` file executable: `chmod +x app/bot.py`\n\nrun the bot: `app/bot.py` or `cd app \u0026\u0026 ./bot.py`\n\nalso you can run the bot in auto-reload mode \nso it will reload the application every time you change a file:\n\n`./bot.py --reload`\n\n\n\n## Deployment\n\n### deploy with docker\n\n- soon...\n\n## TODO\n\n- [ ] None\n\n## \n\nIf you have any question or it's anything wrong with the app just open a github issue.\n\nAny suggestion or contribution will be appreciated.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fastronuttt%2Faiogram-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fastronuttt%2Faiogram-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fastronuttt%2Faiogram-template/lists"}