aiogram

aiogram is a modern and fully asynchronous framework for Telegram Bot API written in Python using asyncio

https://github.com/aiogram/aiogram

Science Score: 44.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (12.8%) to scientific vocabulary

Keywords

aiogram asyncio bot bot-framework python telegram-bot telegram-bot-api

Keywords from Contributors

json-schema pydantic profiler multi-agents application agents python39 python313 python312 python311
Last synced: 6 months ago · JSON representation ·

Repository

aiogram is a modern and fully asynchronous framework for Telegram Bot API written in Python using asyncio

Basic Info
  • Host: GitHub
  • Owner: aiogram
  • License: mit
  • Language: Python
  • Default Branch: dev-3.x
  • Homepage: https://aiogram.dev
  • Size: 9.23 MB
Statistics
  • Stars: 5,266
  • Watchers: 100
  • Forks: 892
  • Open Issues: 38
  • Releases: 89
Topics
aiogram asyncio bot bot-framework python telegram-bot telegram-bot-api
Created over 8 years ago · Last pushed 7 months ago
Metadata Files
Readme Changelog Contributing Funding License Citation

README.rst

#######
aiogram
#######

.. image:: https://img.shields.io/pypi/l/aiogram.svg?style=flat-square
    :target: https://opensource.org/licenses/MIT
    :alt: MIT License

.. image:: https://img.shields.io/pypi/status/aiogram.svg?style=flat-square
    :target: https://pypi.python.org/pypi/aiogram
    :alt: PyPi status

.. image:: https://img.shields.io/pypi/v/aiogram.svg?style=flat-square
    :target: https://pypi.python.org/pypi/aiogram
    :alt: PyPi Package Version

.. image:: https://img.shields.io/pypi/dm/aiogram.svg?style=flat-square
    :target: https://pypi.python.org/pypi/aiogram
    :alt: Downloads

.. image:: https://img.shields.io/pypi/pyversions/aiogram.svg?style=flat-square
    :target: https://pypi.python.org/pypi/aiogram
    :alt: Supported python versions

.. image:: https://img.shields.io/badge/dynamic/json?color=blue&logo=telegram&label=Telegram%20Bot%20API&query=%24.api.version&url=https%3A%2F%2Fraw.githubusercontent.com%2Faiogram%2Faiogram%2Fdev-3.x%2F.butcher%2Fschema%2Fschema.json&style=flat-square
    :target: https://core.telegram.org/bots/api
    :alt: Telegram Bot API

.. image:: https://img.shields.io/github/actions/workflow/status/aiogram/aiogram/tests.yml?branch=dev-3.x&style=flat-square
    :target: https://github.com/aiogram/aiogram/actions
    :alt: Tests

.. image:: https://img.shields.io/codecov/c/github/aiogram/aiogram?style=flat-square
    :target: https://app.codecov.io/gh/aiogram/aiogram
    :alt: Codecov

**aiogram** is a modern and fully asynchronous framework for
`Telegram Bot API `_ written in Python 3.8+ using
`asyncio `_ and
`aiohttp `_.

Make your bots faster and more powerful!

Documentation:
 - 🇺🇸 `English `_
 - 🇺🇦 `Ukrainian `_


Features
========

- Asynchronous (`asyncio docs `_, :pep:`492`)
- Has type hints (:pep:`484`) and can be used with `mypy `_
- Supports `PyPy `_
- Supports `Telegram Bot API 9.2 `_ and gets fast updates to the latest versions of the Bot API
- Telegram Bot API integration code was `autogenerated `_ and can be easily re-generated when API gets updated
- Updates router (Blueprints)
- Has Finite State Machine
- Uses powerful `magic filters `_
- Middlewares (incoming updates and API calls)
- Provides `Replies into Webhook `_
- Integrated I18n/L10n support with GNU Gettext (or Fluent)


.. warning::

    It is strongly advised that you have prior experience working
    with `asyncio `_
    before beginning to use **aiogram**.

    If you have any questions, you can visit our community chats on Telegram:

    - 🇺🇸 `@aiogram `_
    - 🇺🇦 `@aiogramua `_
    - 🇺🇿 `@aiogram_uz `_
    - 🇰🇿 `@aiogram_kz `_
    - 🇷🇺 `@aiogram_ru `_
    - 🇮🇷 `@aiogram_fa `_
    - 🇮🇹 `@aiogram_it `_
    - 🇧🇷 `@aiogram_br `_

Owner

  • Name: aiogram
  • Login: aiogram
  • Kind: organization
  • Email: github@aiogram.dev

Citation (CITATION.cff)

# This CITATION.cff file was generated with cffinit.
# Visit https://bit.ly/cffinit to generate yours today!

cff-version: 1.2.0
title: aiogram
message: >-
  If you use this software, please cite it using the
  metadata from this file.
type: software
authors:
  - given-names: Oleksandr
    family-names: Onufriichuk
    email: im@aiogram.dev
repository-code: 'https://github.com/aiogram/aiogram'
url: 'https://aiogram.dev'
abstract: >-
  aiogram is a modern and fully asynchronous framework for
  Telegram Bot API written in Python using asyncio
keywords:
  - aiogram
  - telegram
  - bot
license: MIT

Committers

Last synced: 8 months ago

All Time
  • Total Commits: 1,921
  • Total Committers: 129
  • Avg Commits per committer: 14.891
  • Development Distribution Score (DDS): 0.274
Past Year
  • Commits: 92
  • Committers: 30
  • Avg Commits per committer: 3.067
  • Development Distribution Score (DDS): 0.457
Top Committers
Name Email Commits
Alex Root Junior j****r@g****m 1,395
Oleg A t****r@m****u 86
Suren Khorenyan s****n@g****m 72
birdi e****7@g****m 47
Nikita 4****k 46
Kostiantyn Kriuchkov 3****d 17
Arslan 'Ars2014' Sakhapov m****f@y****u 15
darksidecat 5****t 11
Evgen Fil e****1@y****u 9
Boger k****e@g****m 9
Bunk100 3****0 9
mpa m****a@s****u 9
Gabben g****n@p****m 9
Sergey i****1@g****m 7
Andrew 1****0 6
Arwichok a****k@g****m 6
Daria d****s@u****t 6
Kolay k****v@y****u 5
sheldy 8****g 4
nullmatawasoradesu 1****e 4
Daniil Kovalenko 4****9 4
Egor B****7 3
Forden m****2@g****m 3
Desiders 4****s 3
Danipulok 4****k 3
Daniil h****d@y****u 3
Andrey Tikhonov a****v@q****m 3
Aleksandr g****a@p****m 3
Martin Winks 5****x 3
Jess j****r@g****m 2
and 99 more...

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 297
  • Total pull requests: 377
  • Average time to close issues: 6 months
  • Average time to close pull requests: about 2 months
  • Total issue authors: 221
  • Total pull request authors: 124
  • Average comments per issue: 1.94
  • Average comments per pull request: 2.14
  • Merged pull requests: 266
  • Bot issues: 0
  • Bot pull requests: 1
Past Year
  • Issues: 52
  • Pull requests: 126
  • Average time to close issues: 19 days
  • Average time to close pull requests: 7 days
  • Issue authors: 44
  • Pull request authors: 43
  • Average comments per issue: 1.06
  • Average comments per pull request: 1.69
  • Merged pull requests: 83
  • Bot issues: 0
  • Bot pull requests: 1
Top Authors
Issue Authors
  • Olegt0rr (16)
  • evgfilim1 (8)
  • JrooTJunior (8)
  • antos07 (6)
  • MasterGroosha (5)
  • NiKuma0 (4)
  • HadiH2o (3)
  • Latand (3)
  • 0xlucyy (3)
  • Desiders (3)
  • asimaranov (3)
  • andrew000 (3)
  • makarworld (2)
  • n-leonovets (2)
  • xDayTripperx (2)
Pull Request Authors
  • JrooTJunior (142)
  • Olegt0rr (51)
  • Latand (13)
  • andrew000 (11)
  • RootShinobi (8)
  • chirizxc (7)
  • sheldygg (7)
  • imsLmaooo (6)
  • Robotvasya (6)
  • Vadim-Khristenko (6)
  • mahenzon (5)
  • MelissaLemon (5)
  • cyborg728 (4)
  • sdmway (4)
  • monosans (4)
Top Labels
Issue Labels
bug (113) enhancement (70) 3.x (42) good first issue (19) upstream (18) confirmed (18) 2.x (16) needs triage (15) docs (15) under discussion (13) wontfix (11) new feature (10) help wanted (8) waiting for reply (6) invalid (4) question issue (4) stale (4) typing (2) api (2) security (2) tests (1) breaking (1) code style (1)
Pull Request Labels
3.x (407) skip news (68) api (41) enhancement (37) bug (32) docs (30) 2.x (18) new feature (16) breaking (15) docs-i18n (6) ported (3) code style (3) invalid (3) under discussion (2) tests (2) typing (2) dependencies (2) github_actions (2) confirmed (1) wontfix (1)

Packages

  • Total packages: 5
  • Total downloads:
    • pypi 1,467,429 last-month
  • Total docker downloads: 41,020,472
  • Total dependent packages: 76
    (may contain duplicates)
  • Total dependent repositories: 2,848
    (may contain duplicates)
  • Total versions: 200
  • Total maintainers: 4
pypi.org: aiogram

Modern and fully asynchronous framework for Telegram Bot API

  • Versions: 116
  • Dependent Packages: 76
  • Dependent Repositories: 2,847
  • Downloads: 1,467,258 Last month
  • Docker Downloads: 41,020,472
Rankings
Dependent repos count: 0.2%
Dependent packages count: 0.4%
Docker downloads count: 0.5%
Downloads: 0.7%
Average: 0.7%
Stargazers count: 1.1%
Forks count: 1.6%
Maintainers (2)
Last synced: 6 months ago
proxy.golang.org: github.com/aiogram/aiogram
  • Versions: 76
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent packages count: 7.0%
Average: 8.2%
Dependent repos count: 9.3%
Last synced: 6 months ago
pypi.org: aiogram-dev2

Is a pretty simple and fully asynchronous framework for Telegram Bot API

  • Versions: 2
  • Dependent Packages: 0
  • Dependent Repositories: 1
  • Downloads: 42 Last month
Rankings
Stargazers count: 1.1%
Forks count: 1.6%
Dependent packages count: 10.1%
Average: 10.8%
Downloads: 19.7%
Dependent repos count: 21.5%
Maintainers (1)
Last synced: 6 months ago
pypi.org: aiogram-types

Full-featured types for aiogram

  • Versions: 5
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 0
Rankings
Stargazers count: 1.3%
Forks count: 1.8%
Dependent packages count: 4.8%
Dependent repos count: 6.3%
Average: 12.9%
Downloads: 50.4%
Last synced: about 1 year ago
pypi.org: aiogram-dev3quest

Modern and fully asynchronous framework for Telegram Bot API

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 129 Last month
Rankings
Stargazers count: 1.6%
Forks count: 2.0%
Dependent packages count: 9.2%
Average: 16.2%
Dependent repos count: 51.8%
Maintainers (1)
Last synced: 10 months ago

Dependencies

.github/workflows/label_pr.yaml actions
  • andymckay/labeler master composite
.github/workflows/pull_request_changelog.yml actions
  • actions/checkout master composite
  • actions/setup-python v2 composite
  • peter-evans/create-or-update-comment v2 composite
  • peter-evans/find-comment v2 composite
.github/workflows/pypi-release.yml actions
  • actions/checkout master composite
  • actions/download-artifact v1 composite
  • actions/setup-python v4 composite
  • actions/upload-artifact v2 composite
  • pypa/gh-action-pypi-publish release/v1 composite
.github/workflows/tests.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
  • codecov/codecov-action v3 composite
  • shogo82148/actions-setup-redis v1 composite
tests/docker-compose.yml docker
  • redis 6-alpine
pyproject.toml pypi
  • aiofiles ~=23.1.0
  • aiohttp ~=3.8.5
  • certifi >=2023.7.22
  • magic-filter ~=1.0.11
  • pydantic >=2.1.1,<2.4
  • typing-extensions ~=4.7.1