Telegram bot (Python, aiogram 3)

What it includes

Routers, typed handlers, polling or an aiohttp webhook server with secret-token verification and /healthz.

File tree

telegram-aiogram/
├── bot/
│   ├── __init__.py
│   ├── logic.py
│   └── main.py
├── tests/
│   └── test_logic.py
├── .dockerignore
├── .env.example
├── .gitignore
├── Dockerfile
├── LICENSE
├── README.md
├── requirements-dev.txt
└── requirements.txt

Setup

unzip telegram-aiogram.zip && cd telegram-aiogram
python -m venv .venv && . .venv/bin/activate
pip install -r requirements-dev.txt
cp .env.example .env
set -a; . ./.env; set +a; python -m bot.main
pytest -q

Fill in .env with credentials from the platform's official developer console. Never commit it: the included .gitignore excludes it.

Run with Docker

docker build -t telegram-aiogram .
docker run --rm --env-file .env telegram-aiogram

Official documentation

https://docs.aiogram.dev

All templates