python/aiogram
1
0
Fork 0
mirror of https://github.com/aiogram/aiogram.git synced 2026-04-08 16:37:47 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 5
aiogram/.serena/memories/project_overview.md
Alex Root Junior 9f49c0413f
Added full support for the Bot API 9.6 (#1792) 
* Added full support for the Bot API 9.6

* Add support for `managed_bot` updates

* Set `description_parse_mode` default to `"parse_mode"` and use `DateTime` for `addition_date` in `PollOption`

* Update changelog with features and changes from Bot API 9.6

* Add changelog fragment generator and update poll parameter descriptions
2026-04-04 01:22:08 +03:00

2 KiB
Raw Blame History

Project Overview: aiogram

Purpose

aiogram is a modern, fully asynchronous Python framework for the Telegram Bot API (currently supports Bot API 9.5+). It provides a high-level interface for building Telegram bots using asyncio.

Tech Stack

  • Python: 3.10–3.14 (also supports PyPy)
  • Async runtime: asyncio + aiohttp (HTTP client)
  • Data validation: Pydantic v2
  • Package manager: uv
  • Linter/formatter: ruff (check + format)
  • Type checker: mypy
  • Testing: pytest with pytest-asyncio, aresponses
  • Docs: Sphinx (reStructuredText), sphinx-autobuild
  • Changelog: towncrier
  • Code generation: butcher (aiogram-cli) — generates types, methods, enums from Bot API schema

Key Links

Architecture Summary

The framework is layered:

  1. aiogram/client/ — Bot class (all API methods as shortcuts), session management, context controller
  2. aiogram/types/ — Pydantic models for all Telegram types (TelegramObject base)
  3. aiogram/methods/ — TelegramMethod[ReturnType] subclasses, one per Bot API method
  4. aiogram/dispatcher/ — Dispatcher, Router (blueprints), middleware, event observers
  5. aiogram/filters/ — Filter classes for routing
  6. aiogram/fsm/ — Finite State Machine (states, storage backends)
  7. aiogram/enums/ — Enumerations (ContentType, UpdateType, etc.)
  8. aiogram/utils/ — Text decoration, keyboards, i18n, etc.
  9. aiogram/webhook/ — Webhook server integrations (aiohttp, FastAPI, etc.)
  10. .butcher/ — Code generation inputs: YAML/JSON configs for types/methods/enums + Jinja2 templates

Optional extras

  • fast — uvloop + aiodns
  • redis — Redis FSM storage
  • mongo — MongoDB FSM storage
  • proxy — SOCKS proxy support
  • i18n — Babel-based i18n
  • cli — butcher codegen CLI
  • signature — cryptographic signature verification