# pyrogram/pyrogram

Elegant, modern and asynchronous Telegram MTProto API framework in Python for users and bots

Repository: https://github.com/pyrogram/pyrogram
Canonical: https://ross.abutalabs.com/products/pyrogram
Homepage: https://pyrogram.org
Language: Python
License: LGPL-3.0
License Family: copyleft
Topics: telegram, mtproto, client, library, python, pyrogram, framework, async
Archived: true
Last push: 2024-12-23T21:00:22+00:00

## Health v2 (maintenance only)
Score: 10/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 3186, "days_push": 618, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, archived
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 4619, forks 1384 (observed 2026-08-28T04:08:55.142905+00:00)

## What it is
Pyrogram is an elegant, modern and asynchronous Python framework for the Telegram MTProto API, usable with both user accounts and bot identities. It provides full access to Telegram's API with type-hinted, high-level abstractions.

## Use cases
- build a telegram bot in python
- automate a telegram user account
- send and receive telegram messages programmatically
- scrape messages from telegram channels
- create a telegram bot without the bot api
- write async telegram client scripts

## When to choose
- you need full Telegram API access beyond the Bot API
- you want an async Python client for user accounts or bots
- you need a type-hinted, high-level Telegram library

## When to avoid
- you need actively maintained software - the project is no longer maintained or supported
- you only need simple Bot API features and prefer official tooling
- you need guaranteed long-term security updates

## Facets
- artifact type: library
- maturity: abandoned
- function: sdk, http-client, cryptography
- domain: messaging-platforms, developer-tools
- platform: python, cross-platform
- tags: telegram, mtproto, async, bots, userbot, automation

## Member repositories
- pyrogram/pyrogram (main) score 10

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:55.142905+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:19:39.954255+00:00, confidence not recorded.
  - readme: https://github.com/pyrogram/pyrogram (fetched 2026-08-28T04:08:55.142905+00:00, sha 45a9b16401c1)
  - registry_pypi: https://pypi.org/pypi/pyrogram/json (fetched 2026-08-29T09:04:34.245757+00:00, sha 057bd518483c)
- Data as of 2026-08-30T08:39:29.467469+00:00.