aiogram
Modern and fully asynchronous framework for Telegram Bot API
Decision gist · record as of 2026-08-14
Yes. aiogram is production-stable, actively maintained, has low install friction, carries a permissive MIT license, and supports current Python versions. It is the right choice if you need to build asynchronous Telegram bots and have asyncio experience. No security vulnerabilities are known. The main prerequisite is comfort with async/await patterns.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later and prior experience with asyncio; a valid Telegram Bot API token is needed to run bots.
- Low install friction with a pure-Python wheel.
- Actively maintained with a recent release (28 days old) and an active repository with 5829 stars.
License · maintenance · safety
MIT (permissive) — MIT license permits commercial and private use with minimal restrictions, making it suitable for most projects.
last release 2026-07-17 (28 days) · last repo commit 2026-08-08 · 5,829 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 4,037,693 downloads/mo, #2,394 on PyPI
Alternatives
Verify before relying
pip install aiogram
from aiogram import Bot, Dispatcher, types
from aiogram.filters import Command
import asyncio
bot = Bot(token="YOUR_BOT_TOKEN")
dp = Dispatcher()
@dp.message(Command("start"))
async def start_handler(message: types.Message):
await message.answer("Hello!")
async def main():
await dp.start_polling(bot)
asyncio.run(main())- Whether the autogenerated Telegram Bot API integration covers all endpoints in API version 10.2 or if manual updates are sometimes required.
- Performance characteristics and concurrency limits when handling high-volume update streams.
What it is and what it does
aiogram is a fully asynchronous framework for building Telegram bots in Python 3.10+, built on asyncio and aiohttp. It provides type hints (compatible with mypy), automatic Telegram Bot API integration code generation, routing via Blueprints, a Finite State Machine for conversation flow, powerful magic filters for message matching, middleware support for both incoming updates and API calls, and integrated internationalization via GNU Gettext or Fluent. The framework is designed to make bots faster and more powerful by leveraging Python's async capabilities.
The package depends on aiofiles, aiohttp, certifi, magic-filter, pydantic, and typing-extensions. It is actively maintained, supports current Python versions (3.10 through 3.14, including PyPy), and has no known security vulnerabilities. The documentation is available in multiple languages and the project maintains active community channels. Prior asyncio experience is strongly recommended before using aiogram.
Use it for
- Build responsive Telegram bots that handle concurrent user interactions without blocking.
- Create stateful conversation flows using the built-in Finite State Machine for multi-step dialogs.
- Organize complex bot logic with Blueprints and routers for modular, maintainable code.
- Implement custom message filtering and routing with magic filters for flexible update handling.
- Integrate internationalization into bots with built-in I18n/L10n support.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
aiogram is production-stable, actively maintained, has low install friction, carries a permissive MIT license, and supports current Python versions. It is the right choice if you need to build asynchronous Telegram bots and have asyncio experience. No security vulnerabilities are known. The main prerequisite is comfort with async/await patterns.
Install
aiogram on PyPI
Before you install
Low install friction with a pure-Python wheel. Actively maintained with a recent release (28 days old) and an active repository with 5829 stars. Requires Python 3.10 or later.
Requires Python 3.10 or later and prior experience with asyncio; a valid Telegram Bot API token is needed to run bots.
License in practice
MIT license permits commercial and private use with minimal restrictions, making it suitable for most projects.
Quickstart
pip install aiogram
from aiogram import Bot, Dispatcher, types
from aiogram.filters import Command
import asyncio
bot = Bot(token="YOUR_BOT_TOKEN")
dp = Dispatcher()
@dp.message(Command("start"))
async def start_handler(message: types.Message):
await message.answer("Hello!")
async def main():
await dp.start_polling(bot)
asyncio.run(main())Verify before relying
- Whether the autogenerated Telegram Bot API integration covers all endpoints in API version 10.2 or if manual updates are sometimes required.
- Performance characteristics and concurrency limits when handling high-volume update streams.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release <3.15,>=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 6 packagesaiofilesaiohttpcertifimagic-filterpydantictyping-extensions |
| Maintenance | Actively maintained 28 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 4,037,693 / month, #2,394 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableEnvironment :: ConsoleFramework :: AsyncIOIntended Audience :: DevelopersIntended Audience :: System AdministratorsLicense :: OSI Approved :: MIT LicenseProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: Implementation :: PyPyTopic :: Communications :: ChatTopic :: Software Development :: Libraries :: Application FrameworksTopic :: Software Development :: Libraries :: Python ModulesTyping :: Typed |
Evidence: aiogram-3.30.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “asyncio telegram api wrapper”
- aiogramaiogram is an asynchronous Python framework for building Telegram…
- TelethonTelethon is an asyncio-based Python library that implements the…
- python-telegram-botProvides a pure Python asynchronous interface to the Telegram Bot…
Give your agent the search over MCP, or paste the wish link into any chat.
More Python Modules packages
Converts domain names between Unicode and ASCII-compatible encoding (Punycode) according to IDNA 2008 and Unicode Technical Standard 46, with security validation and broader script coverage than the standard library.
Install it if you work with internationalized domain names, need to validate domains, or use HTTP clients that depend on it transitively.
Setuptools is a Python build backend and package management tool that handles building, distributing, and installing Python packages, including support for C/C++ extension modules.
PyYAML parses and emits YAML 1.1 data format, enabling serialization and deserialization of configuration files and Python objects to and from human-readable YAML text.
Pydantic validates Python data structures against type hints, coercing and checking input at runtime to ensure it matches a declared schema.
Provides reusable metadata objects for use with PEP-593 `typing.Annotated` to express common constraints like bounds, collection sizes, and predicates on types.
Install it if you use or build libraries that need to express type constraints in a standardized, inspectable way—or if you want to annotate your own types with…
Provides runtime tools to inspect and introspect Python type annotations, enabling programmatic examination of type hints at execution time.
See also pyTelegramBotAPI · Pyrogram · Kurigram · python-telegram-bot · nonebot2 · telebot · aiosignal · botbuilder-integration-aiohttp · Telethon · exteragram-alib