wakaree/aiogram_bot_template

Khởi tạo nhanh bot Telegram với Aiogram 3.x và PostgreSQL

Một mẫu dự án bot Telegram hoàn chỉnh, tích hợp Aiogram 3.x, PostgreSQL, Redis và FastAPI — chỉ cần vài lệnh là chạy được.

aiogram_bot_template là một template bot Telegram được xây dựng trên Aiogram 3.x, kết hợp PostgreSQL (qua asyncpg), SQLAlchemy, Alembic để quản lý cơ sở dữ liệu, Redis dùng cho FSM và cache, cùng FastAPI để xây dựng API. Dự án hỗ trợ đa dạng ngôn ngữ nhờ Project Fluent, được quản lý bởi uv và triển khai dễ dàng với Docker.

✨ Điểm nổi bật

• Aiogram 3.x: Framework bot Telegram hiện đại, hỗ trợ xử lý bất đồng bộ mạnh mẽ.
• PostgreSQL + asyncpg: Cơ sở dữ liệu quan hệ mạnh mẽ, kết nối bất đồng bộ tối ưu hiệu năng.
• SQLAlchemy + Alembic: Quản lý ORM và migration cơ sở dữ liệu chuyên nghiệp.
• Redis: Lưu trữ FSM và cache nhanh chóng.
• FastAPI: Xây dựng API đồng thời với bot.
• Project Fluent: Hệ thống đa ngôn ngữ hiện đại.
• Docker + docker-compose: Triển khai nhanh chóng với môi trường chuẩn.
• uv: Quản lý gói và môi trường Python siêu nhanh.

💡 Vì sao đáng chú ý

Đây không chỉ là một template đơn thuần — mà là một dự án tham khảo đầy đủ các thành phần cần thiết cho một bot Telegram thực tế: từ quản lý cơ sở dữ liệu, migration, cache đến API và đa ngôn ngữ. Dự án được thiết kế để phát triển nhanh (fast development) và triển khai dễ dàng nhờ Docker, đồng thời tuân thủ các nguyên best practices của cộng đồng Python.

Phù hợp với cả nhà phát triển mới bắt đầu và người muốn xây dựng nền tảng vững chắc cho bot thương mại hoặc cá nhân.

---

#Aiogram3 #TelegramBot #FastAPI #PostgreSQL #TiniX