Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

Python library to help you build your own Telegram clients

Project description


Welcome to Python-Telegram! Python-Telegram is a python wrapper for tdlib, completely Object-Oriented and originally based on tdlib's suggested libs for python.


Installing the library is super easy. First, be sure to have Python3 installed in your server: apt install python3

Then, simply execute the installation script: python3 install

And you're ready to go!

A simple script

Here's a simple script that prints every update it receives from Telegram:

from pytglib.client import Telegram

# Change the values below
api_id = 7
api_hash = '123412341234123412341234'
phone_number = '+12312312312'
dbenc = '32_hexademical_chars'

# Initiate the client
client = Telegram(api_id=api_id, api_hash=api_hash, phone=phone_number, database_encryption_key=dbenc)

# Login to the client

# Define the handler function
def my_message_handler(update):

# Register it


# And you're ready to go!

For more complex scripts, go to the Examples section below:

Documentation and examples

The documentation is not complete at the moment, but you can see some examples in examples tree. Of course, we're doing our best to finish the documentation as soon as possible. By the way, there's an auto generated documentation here; It can help to find out about types and functions of the library.

Bugs and questions

If there is any buys or questions about the library, feel free to contact any member of our team on Telegram:

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for Pytglib, version 0.3
Filename, size File type Python version Upload date Hashes
Filename, size Pytglib-0.3-py3.6.egg (1.7 MB) File type Egg Python version 3.6 Upload date Hashes View hashes
Filename, size Pytglib-0.3-py3.7.egg (1.7 MB) File type Egg Python version 3.7 Upload date Hashes View hashes
Filename, size Pytglib-0.3-py3-none-any.whl (692.9 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size Pytglib-0.3.tar.gz (236.1 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page