![ptbcontrib Logo](https://github.com/python-telegram-bot/logos/raw/master/ptbcontrib/png/ptbcontrib-logo-text_768.png?raw=true)
Community-based extensions for the python-telegram-bot library.
Table of contents
Introduction
This library provides extensions for the python-telegram-bot library written and maintained by the community of PTB users.
Installing
Because this library is subject to more frequent changes than PTB, it is not available via PyPi. You can still install it via pip:
$ pip install git+https://github.com/python-telegram-bot/ptbcontrib.git
If you want to use an extension that has some special requirements, you can install them on the fly as e.g.
$ pip install "ptbcontrib[extension1,extension2] @ git+https://github.com/python-telegram-bot/ptbcontrib.git"
Or you can install from source with:
$ git clone https://github.com/python-telegram-bot/ptbcontrib
$ cd ptbcontrib
$ python setup.py install
Getting help
You can get help in several ways:
- We have a vibrant community of developers helping each other in our Telegram group. Join us!
- In case you are unable to join our group due to Telegram restrictions, you can use our IRC channel.
- Report bugs, request new features or ask questions by creating an issue.
Contributing
Contributions of all sizes are welcome. Please review our contribution guidelines to get started. You can also help by reporting bugs.
License
You may copy, distribute and modify the software provided that modifications are described and licensed for free under LGPL-3. Derivatives works (including modifications or anything statically linked to the library) can only be redistributed under LGPL-3, but applications that use the library don't have to be.