tdlib/telegram-bot-api

Health v2 · maintenance only

Flags: no_releases

Adoption not part of the score

4431 stars · 900 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

An open-source C++ server that implements the Telegram Bot API as an HTTP service, built on TDLib. It can be self-hosted to run bots against a local Bot API endpoint with fewer restrictions than the cloud api.telegram.org.

Use cases

• self-host the Telegram Bot API server for my bot
• download and upload large files through a local Bot API server
• use a local webhook with HTTP and custom ports
• serve file_path as a local path without downloading files
• run Telegram bots with higher file size limits
• move a bot from cloud Bot API to a local server

When to choose

• your bot needs file uploads up to 2000 MB or unlimited downloads
• you want local file paths and local webhook support
• you need to self-host the Bot API for performance or data control

When to avoid

• your bot works fine with the hosted api.telegram.org endpoint
• you cannot obtain your own api_id and api_hash
• you need HTTPS directly without a TLS termination proxy

Facets

service · maturity active

http-server api-framework chatbot webhook messaging-platforms chatbots apis self-hosted developer-tools windows cpp cross-platform self-hosted telegram bot-api local-bot-api-server tdlib http-api linux macos

Member repositories

For agents

markdown · JSON · MCP: product_card(name="tdlib/telegram-bot-api")