{"adoption": {"forks": 1644, "observed_at": "2026-08-28T04:10:51.642855+00:00", "stars": 12059}, "canonical_url": "https://ross.abutalabs.com/products/telethon", "card": {"archived": true, "artifact_type": "library", "description": "Pure Python 3 MTProto API Telegram client library, for bots too!", "domain": ["messaging-platforms", "apis", "developer-tools"], "enriched": true, "function": ["http-client", "sdk", "developer-tools"], "health_score": 10, "homepage": "https://docs.telethon.dev", "language": "Python", "license": "MIT", "license_family": "permissive", "maturity": "active", "member_repos": ["LonamiWebs/Telethon"], "name": "LonamiWebs/Telethon", "platform": ["python", "cross-platform"], "pushed_at": "2026-02-21T21:11:58+00:00", "repo": "LonamiWebs/Telethon", "stars": 12059, "tags": ["telegram", "mtproto", "asyncio", "bot-api-alternative", "messaging", "automation"], "topics": ["library", "telegram", "telegram-api", "telethon", "mtproto", "python-library", "hacktoberfest"], "urls": [], "use_cases": ["build a telegram bot in python", "automate sending messages to telegram channels", "download media from telegram chats", "scrape telegram group messages", "create a userbot that reacts to new messages", "interact with telegram api without the bot api"], "what_it_is": "Telethon is a pure Python 3 asyncio MTProto library for interacting with Telegram's full API, either as a user account or a bot, serving as an alternative to the HTTP Bot API. It wraps Telegram's low-level protocol so developers can send messages, download media, and handle events with simple Python code.", "when_to_avoid": ["you only need simple bot features and prefer the official HTTP Bot API's simplicity", "you cannot accept the risk of account bans from third-party client usage", "you need a library in a language other than Python"], "when_to_choose": ["you need full Telegram client capabilities beyond the Bot API, such as user accounts or raw MTProto access", "you want an asyncio-native Python library with event handlers for new messages", "you need to download or upload media programmatically at high speed"]}, "data_as_of": "2026-08-30T08:39:29.467469+00:00", "members": [{"path": "/products/telethon", "repo": "LonamiWebs/Telethon", "role": "main", "score": 10}], "provenance": {"archived": {"kind": "observed", "observed_at": "2026-08-28T04:10:51.642855+00:00", "source": "github"}, "artifact_type": {"confidence": null, "enriched_at": "2026-08-29T17:14:58.091257+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "4e85ad976fcfe4ff25de3e4efc8dd8cd1aac2fb39d9976c1b9d02f2b30799bdc", "fetched_at": "2026-08-28T04:10:51.642855+00:00", "kind": "readme", "missing": false, "url": "https://github.com/LonamiWebs/Telethon"}, {"content_hash": "7a1d38c98f07b57cd972d111b25d77e7563d710bd7816cde20af35a8ee62e782", "fetched_at": "2026-08-29T08:12:29.787838+00:00", "kind": "homepage", "missing": false, "url": "https://docs.telethon.dev"}, {"content_hash": "1533ee3d53755c52e89e1b6932d4d4873b68022afef5b79c40524fedb55178b8", "fetched_at": "2026-08-29T08:12:29.796626+00:00", "kind": "site_page", "missing": false, "url": "https://docs.telethon.dev/en/stable/basic/installation.html"}, {"content_hash": "287a70ba4a15e9cf7cf215473f054c1378e9d2945a78a84c4d1df2929afac1aa", "fetched_at": "2026-08-29T08:12:29.798382+00:00", "kind": "site_page", "missing": false, "url": "https://docs.telethon.dev/en/stable/quick-references/faq.html"}, {"content_hash": "dfca623bc5d0767f4b4d38e76ae0e7e06318e56bc0eb4d0b490d531e99dd0248", "fetched_at": "2026-08-29T08:12:29.800952+00:00", "kind": "site_page", "missing": false, "url": "https://docs.telethon.dev/en/stable/misc/changelog.html"}], "taxonomy_version": 1}, "description": {"kind": "observed", "observed_at": "2026-08-28T04:10:51.642855+00:00", "source": "github"}, "domain": {"confidence": null, "enriched_at": "2026-08-29T17:14:58.091257+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "4e85ad976fcfe4ff25de3e4efc8dd8cd1aac2fb39d9976c1b9d02f2b30799bdc", "fetched_at": "2026-08-28T04:10:51.642855+00:00", "kind": "readme", "missing": false, "url": "https://github.com/LonamiWebs/Telethon"}, {"content_hash": "7a1d38c98f07b57cd972d111b25d77e7563d710bd7816cde20af35a8ee62e782", "fetched_at": "2026-08-29T08:12:29.787838+00:00", "kind": "homepage", "missing": false, "url": "https://docs.telethon.dev"}, {"content_hash": "1533ee3d53755c52e89e1b6932d4d4873b68022afef5b79c40524fedb55178b8", "fetched_at": "2026-08-29T08:12:29.796626+00:00", "kind": "site_page", "missing": false, "url": "https://docs.telethon.dev/en/stable/basic/installation.html"}, {"content_hash": "287a70ba4a15e9cf7cf215473f054c1378e9d2945a78a84c4d1df2929afac1aa", "fetched_at": "2026-08-29T08:12:29.798382+00:00", "kind": "site_page", "missing": false, "url": "https://docs.telethon.dev/en/stable/quick-references/faq.html"}, {"content_hash": "dfca623bc5d0767f4b4d38e76ae0e7e06318e56bc0eb4d0b490d531e99dd0248", "fetched_at": "2026-08-29T08:12:29.800952+00:00", "kind": "site_page", "missing": false, "url": "https://docs.telethon.dev/en/stable/misc/changelog.html"}], "taxonomy_version": 1}, "enriched": {"inputs": [], "kind": "computed", "method": "enrichment_status"}, "function": {"confidence": null, "enriched_at": "2026-08-29T17:14:58.091257+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "4e85ad976fcfe4ff25de3e4efc8dd8cd1aac2fb39d9976c1b9d02f2b30799bdc", "fetched_at": "2026-08-28T04:10:51.642855+00:00", "kind": "readme", "missing": false, "url": "https://github.com/LonamiWebs/Telethon"}, {"content_hash": "7a1d38c98f07b57cd972d111b25d77e7563d710bd7816cde20af35a8ee62e782", "fetched_at": "2026-08-29T08:12:29.787838+00:00", "kind": "homepage", "missing": false, "url": "https://docs.telethon.dev"}, {"content_hash": "1533ee3d53755c52e89e1b6932d4d4873b68022afef5b79c40524fedb55178b8", "fetched_at": "2026-08-29T08:12:29.796626+00:00", "kind": "site_page", "missing": false, "url": "https://docs.telethon.dev/en/stable/basic/installation.html"}, {"content_hash": "287a70ba4a15e9cf7cf215473f054c1378e9d2945a78a84c4d1df2929afac1aa", "fetched_at": "2026-08-29T08:12:29.798382+00:00", "kind": "site_page", "missing": false, "url": "https://docs.telethon.dev/en/stable/quick-references/faq.html"}, {"content_hash": "dfca623bc5d0767f4b4d38e76ae0e7e06318e56bc0eb4d0b490d531e99dd0248", "fetched_at": "2026-08-29T08:12:29.800952+00:00", "kind": "site_page", "missing": false, "url": "https://docs.telethon.dev/en/stable/misc/changelog.html"}], "taxonomy_version": 1}, "health_score": {"inputs": ["days_since_push", "days_since_release", "archived"], "kind": "computed", "method": "health_v1"}, "homepage": {"kind": "observed", "observed_at": "2026-08-28T04:10:51.642855+00:00", "source": "github"}, "language": {"kind": "observed", "observed_at": "2026-08-28T04:10:51.642855+00:00", "source": "github"}, "license": {"kind": "observed", "observed_at": "2026-08-28T04:10:51.642855+00:00", "source": "github"}, "license_family": {"inputs": ["license"], "kind": "computed", "method": "license_family"}, "maturity": {"confidence": null, "enriched_at": "2026-08-29T17:14:58.091257+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "4e85ad976fcfe4ff25de3e4efc8dd8cd1aac2fb39d9976c1b9d02f2b30799bdc", "fetched_at": "2026-08-28T04:10:51.642855+00:00", "kind": "readme", "missing": false, "url": "https://github.com/LonamiWebs/Telethon"}, {"content_hash": "7a1d38c98f07b57cd972d111b25d77e7563d710bd7816cde20af35a8ee62e782", "fetched_at": "2026-08-29T08:12:29.787838+00:00", "kind": "homepage", "missing": false, "url": "https://docs.telethon.dev"}, {"content_hash": "1533ee3d53755c52e89e1b6932d4d4873b68022afef5b79c40524fedb55178b8", "fetched_at": "2026-08-29T08:12:29.796626+00:00", "kind": "site_page", "missing": false, "url": "https://docs.telethon.dev/en/stable/basic/installation.html"}, {"content_hash": "287a70ba4a15e9cf7cf215473f054c1378e9d2945a78a84c4d1df2929afac1aa", "fetched_at": "2026-08-29T08:12:29.798382+00:00", "kind": "site_page", "missing": false, "url": "https://docs.telethon.dev/en/stable/quick-references/faq.html"}, {"content_hash": "dfca623bc5d0767f4b4d38e76ae0e7e06318e56bc0eb4d0b490d531e99dd0248", "fetched_at": "2026-08-29T08:12:29.800952+00:00", "kind": "site_page", "missing": false, "url": "https://docs.telethon.dev/en/stable/misc/changelog.html"}], "taxonomy_version": 1}, "member_repos": {"kind": "observed", "observed_at": "2026-08-28T04:10:51.642855+00:00", "source": "github"}, "name": {"kind": "observed", "observed_at": "2026-08-28T04:10:51.642855+00:00", "source": "github"}, "platform": {"confidence": null, "enriched_at": "2026-08-29T17:14:58.091257+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "4e85ad976fcfe4ff25de3e4efc8dd8cd1aac2fb39d9976c1b9d02f2b30799bdc", "fetched_at": "2026-08-28T04:10:51.642855+00:00", "kind": "readme", "missing": false, "url": "https://github.com/LonamiWebs/Telethon"}, {"content_hash": "7a1d38c98f07b57cd972d111b25d77e7563d710bd7816cde20af35a8ee62e782", "fetched_at": "2026-08-29T08:12:29.787838+00:00", "kind": "homepage", "missing": false, "url": "https://docs.telethon.dev"}, {"content_hash": "1533ee3d53755c52e89e1b6932d4d4873b68022afef5b79c40524fedb55178b8", "fetched_at": "2026-08-29T08:12:29.796626+00:00", "kind": "site_page", "missing": false, "url": "https://docs.telethon.dev/en/stable/basic/installation.html"}, {"content_hash": "287a70ba4a15e9cf7cf215473f054c1378e9d2945a78a84c4d1df2929afac1aa", "fetched_at": "2026-08-29T08:12:29.798382+00:00", "kind": "site_page", "missing": false, "url": "https://docs.telethon.dev/en/stable/quick-references/faq.html"}, {"content_hash": "dfca623bc5d0767f4b4d38e76ae0e7e06318e56bc0eb4d0b490d531e99dd0248", "fetched_at": "2026-08-29T08:12:29.800952+00:00", "kind": "site_page", "missing": false, "url": "https://docs.telethon.dev/en/stable/misc/changelog.html"}], "taxonomy_version": 1}, "pushed_at": {"kind": "observed", "observed_at": "2026-08-28T04:10:51.642855+00:00", "source": "github"}, "repo": {"kind": "observed", "observed_at": "2026-08-28T04:10:51.642855+00:00", "source": "github"}, "stars": {"kind": "observed", "observed_at": "2026-08-28T04:10:51.642855+00:00", "source": "github"}, "tags": {"confidence": null, "enriched_at": "2026-08-29T17:14:58.091257+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "4e85ad976fcfe4ff25de3e4efc8dd8cd1aac2fb39d9976c1b9d02f2b30799bdc", "fetched_at": "2026-08-28T04:10:51.642855+00:00", "kind": "readme", "missing": false, "url": "https://github.com/LonamiWebs/Telethon"}, {"content_hash": "7a1d38c98f07b57cd972d111b25d77e7563d710bd7816cde20af35a8ee62e782", "fetched_at": "2026-08-29T08:12:29.787838+00:00", "kind": "homepage", "missing": false, "url": "https://docs.telethon.dev"}, {"content_hash": "1533ee3d53755c52e89e1b6932d4d4873b68022afef5b79c40524fedb55178b8", "fetched_at": "2026-08-29T08:12:29.796626+00:00", "kind": "site_page", "missing": false, "url": "https://docs.telethon.dev/en/stable/basic/installation.html"}, {"content_hash": "287a70ba4a15e9cf7cf215473f054c1378e9d2945a78a84c4d1df2929afac1aa", "fetched_at": "2026-08-29T08:12:29.798382+00:00", "kind": "site_page", "missing": false, "url": "https://docs.telethon.dev/en/stable/quick-references/faq.html"}, {"content_hash": "dfca623bc5d0767f4b4d38e76ae0e7e06318e56bc0eb4d0b490d531e99dd0248", "fetched_at": "2026-08-29T08:12:29.800952+00:00", "kind": "site_page", "missing": false, "url": "https://docs.telethon.dev/en/stable/misc/changelog.html"}], "taxonomy_version": 1}, "topics": {"kind": "observed", "observed_at": "2026-08-28T04:10:51.642855+00:00", "source": "github"}, "urls": {"kind": "observed", "observed_at": "2026-08-28T04:10:51.642855+00:00", "source": "github"}, "use_cases": {"confidence": null, "enriched_at": "2026-08-29T17:14:58.091257+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "4e85ad976fcfe4ff25de3e4efc8dd8cd1aac2fb39d9976c1b9d02f2b30799bdc", "fetched_at": "2026-08-28T04:10:51.642855+00:00", "kind": "readme", "missing": false, "url": "https://github.com/LonamiWebs/Telethon"}, {"content_hash": "7a1d38c98f07b57cd972d111b25d77e7563d710bd7816cde20af35a8ee62e782", "fetched_at": "2026-08-29T08:12:29.787838+00:00", "kind": "homepage", "missing": false, "url": "https://docs.telethon.dev"}, {"content_hash": "1533ee3d53755c52e89e1b6932d4d4873b68022afef5b79c40524fedb55178b8", "fetched_at": "2026-08-29T08:12:29.796626+00:00", "kind": "site_page", "missing": false, "url": "https://docs.telethon.dev/en/stable/basic/installation.html"}, {"content_hash": "287a70ba4a15e9cf7cf215473f054c1378e9d2945a78a84c4d1df2929afac1aa", "fetched_at": "2026-08-29T08:12:29.798382+00:00", "kind": "site_page", "missing": false, "url": "https://docs.telethon.dev/en/stable/quick-references/faq.html"}, {"content_hash": "dfca623bc5d0767f4b4d38e76ae0e7e06318e56bc0eb4d0b490d531e99dd0248", "fetched_at": "2026-08-29T08:12:29.800952+00:00", "kind": "site_page", "missing": false, "url": "https://docs.telethon.dev/en/stable/misc/changelog.html"}], "taxonomy_version": 1}, "what_it_is": {"confidence": null, "enriched_at": "2026-08-29T17:14:58.091257+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "4e85ad976fcfe4ff25de3e4efc8dd8cd1aac2fb39d9976c1b9d02f2b30799bdc", "fetched_at": "2026-08-28T04:10:51.642855+00:00", "kind": "readme", "missing": false, "url": "https://github.com/LonamiWebs/Telethon"}, {"content_hash": "7a1d38c98f07b57cd972d111b25d77e7563d710bd7816cde20af35a8ee62e782", "fetched_at": "2026-08-29T08:12:29.787838+00:00", "kind": "homepage", "missing": false, "url": "https://docs.telethon.dev"}, {"content_hash": "1533ee3d53755c52e89e1b6932d4d4873b68022afef5b79c40524fedb55178b8", "fetched_at": "2026-08-29T08:12:29.796626+00:00", "kind": "site_page", "missing": false, "url": "https://docs.telethon.dev/en/stable/basic/installation.html"}, {"content_hash": "287a70ba4a15e9cf7cf215473f054c1378e9d2945a78a84c4d1df2929afac1aa", "fetched_at": "2026-08-29T08:12:29.798382+00:00", "kind": "site_page", "missing": false, "url": "https://docs.telethon.dev/en/stable/quick-references/faq.html"}, {"content_hash": "dfca623bc5d0767f4b4d38e76ae0e7e06318e56bc0eb4d0b490d531e99dd0248", "fetched_at": "2026-08-29T08:12:29.800952+00:00", "kind": "site_page", "missing": false, "url": "https://docs.telethon.dev/en/stable/misc/changelog.html"}], "taxonomy_version": 1}, "when_to_avoid": {"confidence": null, "enriched_at": "2026-08-29T17:14:58.091257+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "4e85ad976fcfe4ff25de3e4efc8dd8cd1aac2fb39d9976c1b9d02f2b30799bdc", "fetched_at": "2026-08-28T04:10:51.642855+00:00", "kind": "readme", "missing": false, "url": "https://github.com/LonamiWebs/Telethon"}, {"content_hash": "7a1d38c98f07b57cd972d111b25d77e7563d710bd7816cde20af35a8ee62e782", "fetched_at": "2026-08-29T08:12:29.787838+00:00", "kind": "homepage", "missing": false, "url": "https://docs.telethon.dev"}, {"content_hash": "1533ee3d53755c52e89e1b6932d4d4873b68022afef5b79c40524fedb55178b8", "fetched_at": "2026-08-29T08:12:29.796626+00:00", "kind": "site_page", "missing": false, "url": "https://docs.telethon.dev/en/stable/basic/installation.html"}, {"content_hash": "287a70ba4a15e9cf7cf215473f054c1378e9d2945a78a84c4d1df2929afac1aa", "fetched_at": "2026-08-29T08:12:29.798382+00:00", "kind": "site_page", "missing": false, "url": "https://docs.telethon.dev/en/stable/quick-references/faq.html"}, {"content_hash": "dfca623bc5d0767f4b4d38e76ae0e7e06318e56bc0eb4d0b490d531e99dd0248", "fetched_at": "2026-08-29T08:12:29.800952+00:00", "kind": "site_page", "missing": false, "url": "https://docs.telethon.dev/en/stable/misc/changelog.html"}], "taxonomy_version": 1}, "when_to_choose": {"confidence": null, "enriched_at": "2026-08-29T17:14:58.091257+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "4e85ad976fcfe4ff25de3e4efc8dd8cd1aac2fb39d9976c1b9d02f2b30799bdc", "fetched_at": "2026-08-28T04:10:51.642855+00:00", "kind": "readme", "missing": false, "url": "https://github.com/LonamiWebs/Telethon"}, {"content_hash": "7a1d38c98f07b57cd972d111b25d77e7563d710bd7816cde20af35a8ee62e782", "fetched_at": "2026-08-29T08:12:29.787838+00:00", "kind": "homepage", "missing": false, "url": "https://docs.telethon.dev"}, {"content_hash": "1533ee3d53755c52e89e1b6932d4d4873b68022afef5b79c40524fedb55178b8", "fetched_at": "2026-08-29T08:12:29.796626+00:00", "kind": "site_page", "missing": false, "url": "https://docs.telethon.dev/en/stable/basic/installation.html"}, {"content_hash": "287a70ba4a15e9cf7cf215473f054c1378e9d2945a78a84c4d1df2929afac1aa", "fetched_at": "2026-08-29T08:12:29.798382+00:00", "kind": "site_page", "missing": false, "url": "https://docs.telethon.dev/en/stable/quick-references/faq.html"}, {"content_hash": "dfca623bc5d0767f4b4d38e76ae0e7e06318e56bc0eb4d0b490d531e99dd0248", "fetched_at": "2026-08-29T08:12:29.800952+00:00", "kind": "site_page", "missing": false, "url": "https://docs.telethon.dev/en/stable/misc/changelog.html"}], "taxonomy_version": 1}}, "score": {"components": {"activity": 68, "longevity": 100, "rhythm": 8}, "computed_at": "2026-09-03T02:20:16.233290+00:00", "flags": ["archived"], "formula": "round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)", "inputs": {"age_days": 3659, "days_push": 193, "days_rel": null, "gap_med": null, "n_releases_24m": 0}, "score": 10, "version": 2}, "staleness": {"enrichment_outdated": false, "low_confidence": false, "scrape_days": 9, "stale_scrape": false}}