# tdlib/td

Cross-platform library for building Telegram clients

Repository: https://github.com/tdlib/td
Canonical: https://ross.abutalabs.com/products/td
Homepage: https://core.telegram.org/tdlib
Language: C++
License: BSL-1.0
License Family: other
Topics: telegram, cross-platform, library
Last push: 2026-08-24T16:45:28+00:00

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

## Adoption (not part of the score)
Stars 9052, forks 2149 (observed 2026-08-28T04:10:28.152021+00:00)

## What it is
TDLib (Telegram Database Library) is a cross-platform C++ library for building fully functional Telegram clients. It handles networking, MTProto encryption, local data storage, and update consistency, and can be used from nearly any programming language via JSON, C, Java, or .NET interfaces.

## Use cases
- build a custom Telegram client app
- integrate Telegram messaging into my application
- run a Telegram user account or bot programmatically
- embed Telegram chat in a mobile or desktop app
- sync Telegram messages with encrypted local storage
- create a Telegram bot backend that handles many bots at once

## When to choose
- you need full Telegram API coverage beyond what the Bot API offers
- you want a client library that handles networking, encryption, and local storage for you
- you need to target many platforms or languages from one codebase
- you need reliable operation on slow or unreliable connections

## When to avoid
- you only need simple bot features - the plain Bot API over HTTP is far easier
- you cannot build C++ dependencies in your environment
- you need a lightweight pure-language Telegram wrapper instead of a native binary

## Facets
- artifact type: library
- maturity: stable
- function: sdk, cryptography, networking, concurrency, database
- domain: messaging-platforms, developer-tools, privacy, cross-platform
- platform: windows, cpp, wasm, cross-platform, jvm, dotnet
- tags: telegram, telegram-client, mtproto, messaging, chat, json-interface, jni-bindings, async, android, ios, macos, linux

## Member repositories
- tdlib/td (main) score 77

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:28.152021+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:24:02.796528+00:00, confidence not recorded.
  - readme: https://github.com/tdlib/td (fetched 2026-08-28T04:10:28.152021+00:00, sha 8928c80f99ed)
  - homepage: https://core.telegram.org/tdlib (fetched 2026-08-29T08:24:01.656197+00:00, sha d9feab352283)
  - site_page: https://core.telegram.org/tdlib/docs (fetched 2026-08-29T08:24:01.666093+00:00, sha 8781bd114455)
  - site_page: https://core.telegram.org/tdlib/getting-started (fetched 2026-08-29T08:24:01.668220+00:00, sha 03c85ce5c7ea)
  - site_page: https://telegram.org/faq (fetched 2026-08-29T08:24:01.659344+00:00, sha bb96abf682a3)
  - site_page: https://telegram.org/blog/tdlib (fetched 2026-08-29T08:24:01.663780+00:00, sha c151cac27d53)
  - site_page: https://core.telegram.org/tdlib/notification-api (fetched 2026-08-29T08:24:01.670679+00:00, sha d664907070fa)
- Data as of 2026-08-30T08:39:29.467469+00:00.