Python API for the tdlib library. It helps you build your own Telegram clients.
This library requires Python 3.9+ and Linux or MacOS. Windows is not supported.
pip install python-telegramSee documentation for more details.
python-telegram comes with a precompiled tdlib library for Linux and MacOS. But it is highly recommended to compile it yourself.
The precompiled library may not work on some systems, it is dynamically linked and requires specific versions of additional libraries.
### Docker
This library has a [docker image](https://hub.docker.com/r/akhmetov/python-telegram/):
```sh
docker run -i -t --rm \
-v /tmp/docker-python-telegram/:/tmp/ \
akhmetov/python-telegram \
python3 /app/examples/send_message.py $(API_ID) $(API_HASH) $(PHONE) $(CHAT_ID) $(TEXT)Check out the tutorial for more details.
Basic example:
from telegram.client import Telegram
from telegram.text import Spoiler
tg = Telegram(
api_id='api_id',
api_hash='api_hash',
phone='+31611111111', # you can pass 'bot_token' instead
database_encryption_key='changekey123',
files_directory='/tmp/.tdlib_files/',
)
tg.login()
# If this is the first run, the library needs to preload all chats.
# Otherwise, the message will not be sent.
result = tg.get_chats()
result.wait()
chat_id: int
result = tg.send_message(chat_id, Spoiler('Hello world!'))
# `tdlib` is asynchronous, so `python-telegram` always returns an `AsyncResult` object.
# You can receive a result with the `wait` method of this object.
result.wait()
print(result.update)
tg.stop() # You must call `stop` at the end of the script.You can also use call_method to call any tdlib method:
tg.call_method('getUser', params={'user_id': user_id})More examples can be found in the /examples/ directory.
More information is available in the documentation.
See CONTRIBUTING.md.