# eternnoir/pyTelegramBotAPI

Python Telegram bot api.

Repository: https://github.com/eternnoir/pyTelegramBotAPI
Canonical: https://ross.abutalabs.com/products/pytelegrambotapi
Language: Python
License: GPL-2.0
License Family: copyleft
Topics: telegram-bot, telegram, telegram-bot-api, bot-api, python-api
Last push: 2026-08-22T22:38:47+00:00

## Health v2 (maintenance only)
Score: 94/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 85, longevity 100
- inputs: {"age_days": 4086, "days_push": 11, "days_rel": 20, "gap_med": 32, "n_releases_24m": 16}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 8766, forks 2152 (observed 2026-08-28T04:10:25.679223+00:00)

## What it is
pyTelegramBotAPI (TeleBot) is a simple but extensible Python implementation of the Telegram Bot API, supporting both synchronous and asynchronous usage. It provides handlers for messages, callbacks, inline queries, payments, and more, with middleware and custom filter support.

## Use cases
- build a telegram bot in python
- create an echo bot for telegram
- handle telegram callback queries and inline queries
- add middleware to telegram bot message handling
- send messages and media via the telegram bot api
- build a telegram bot with payments and pre-checkout support
- run a telegram bot asynchronously

## When to choose
- you want a lightweight, dependency-light Python wrapper for the full Telegram Bot API
- you need both sync and async bot implementations in one library
- you want fine-grained handler registration for messages, polls, chat members, and inline mode
- you prefer a plain API wrapper over a heavier framework like aiogram

## When to avoid
- you need a full-featured bot framework with built-in FSM/state storage and routing conventions
- you are building bots for platforms other than Telegram
- you require a permissive license - this is GPL-2.0

## Facets
- artifact type: library
- maturity: active
- function: sdk, http-client, middleware, webhook
- domain: messaging-platforms, chatbots, developer-tools
- platform: python, cross-platform
- tags: telegram-bot-api, telegram, bot-framework, sync-and-async, telebot, automation

## Member repositories
- eternnoir/pyTelegramBotAPI (main) score 94

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:25.679223+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-29T17:25:14.292115+00:00, confidence not recorded.
  - readme: https://github.com/eternnoir/pyTelegramBotAPI (fetched 2026-08-28T04:10:25.679223+00:00, sha 15efe565f1ff)
  - registry_pypi: https://pypi.org/pypi/pytelegrambotapi/json (fetched 2026-08-29T08:25:29.437255+00:00, sha f33ab8f0ff2f)
- Data as of 2026-08-30T08:39:29.467469+00:00.