aiogram_bot_template

aiogram_bot_template

Aiogram 3.x bot template using PostgreSQL (asyncpg) with SQLAlchemy + alembic.

Stars: 117

Visit
 screenshot

Aiogram bot template is a boilerplate for creating Telegram bots using Aiogram framework. It provides a solid foundation for building robust and scalable bots with a focus on code organization, database integration, and localization.

README:

aiogram_bot_template

Author License

⚙️ System dependencies

  • Python 3.11+
  • Docker
  • docker-compose
  • make
  • uv

🐳 Quick Start with Docker compose

  • Rename .env.dist to .env and configure it
  • Rename docker-compose.example.yml to docker-compose.yml
  • Run make app-build command then make app-run to start the bot

Use make to see all available commands

🔧 Development

Setup environment

uv sync

Update database tables structure

Make migration script:

make migration message=MESSAGE_WHAT_THE_MIGRATION_DOES

Run migrations:

make migrate

🚀 Used technologies:

  • uv (an extremely fast Python package and project manager)
  • Aiogram 3.x (Telegram bot framework)
  • PostgreSQL (persistent relational database)
  • SQLAlchemy (working with database from Python)
  • Alembic (lightweight database migration tool)
  • Redis (in-memory database for FSM and caching)
  • Project Fluent (modern localization system)

🤝 Contributions

🐛 Bug Reports / ✨ Feature Requests

If you want to report a bug or request a new feature, feel free to open a new issue.

Pull Requests

If you want to help us improve the bot, you can create a new Pull Request.

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

For Tasks:

Click tags to check more tools for each tasks

For Jobs:

Alternative AI tools for aiogram_bot_template

Similar Open Source Tools

For similar tasks

For similar jobs