🤖 Telegram bot template for Aiogram 3.x

The best option for a Telegram bot structure on Aiogram 3.x.

🔥 Features:

• 🌐 Smart AI translation - Built-in intelligent translation support for multi-language bot interactions
• 🏗️ Modern structure - Clean, maintainable project architecture following best practices
• ⚡ Latest Aiogram - Uses the newest Aiogram 3.x framework for robust telegram bot development
• 🐍 Python 3.14 - Powered by the latest Python 3.14 runtime for optimal performance
• 💬 Aiogram dialog library - Integrated dialog system for complex conversation flows
• ⚙️ Easy configuration and startup - Simple setup with environment variables and one-command launch

⬇️ Installation

💡 Require 🐍 Python 3.14

🐳 Install Docker

• Ubuntu/Debian

sudo apt update
sudo apt install docker.io -y

• Windows or MacOS here.

🤖 Create your own Telegram API Server

• Get your API ID and API HASH here.

Or use the default ones:
api_id: 2040
api_hash: b18441a1ff607e10a989891a5462e627

💡 Make sure the port is only working on the localhost.

docker run -d \
  -p 8081:8081 \
  --name telegram-bot-api \
  --restart always \
  -v telegram-bot-api-data:/var/lib/telegram-bot-api \
  -e TELEGRAM_API_ID=your_api_id \
  -e TELEGRAM_API_HASH=your_api_hash \
  aiogram/telegram-bot-api:latest

🐈‍⬛ Clone repository

git clone https://github.com/fajox1/tgbotbase-aiogram3
cd tgbotbase-aiogram3

🗂 Configure environment variables

📁 Rename example.env to .env

• Get your variables and put them into the config.

📚 Libraries

💈 UV installation

• On MacOS and Linux.

curl -LsSf https://astral.sh/uv/install.sh | sh

• On Windows

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

• Via pip

pip install uv

uv init
uv sync

🔥 Start it

uv run -m src

Licensed under GPL GNU 3.0
Developer: @fajox