Aiogram Bot Template (v3)

A scalable template for building Telegram bots using aiogram 3.x and sqlalchemy 2.x

Features

• Built with aiogram
• Database management with SQLAlchemy and asyncpg
• Database migrations with Alembic
• Data storage for FSM with redis-py

System dependencies

• Python 3.12+
• Poetry
• Docker

Installation

Via Docker

• Set up environment variables (.env)
  • Rename .env.example to .env
  • Configure it
• Build and run docker container

  docker-compose up --build -d
  

Via systemd

• Set up environment variables (.env)
  • Rename .env.example to .env
  • Configure it
• Install the dependencies:

  poetry install
  

• Run database migrations

  poetry run alembic upgrade head
  

• Configure .service file
• Start service

  systemctl --now enable tgbot.service