Skip to main content

tgcli is a client tool for Telegram.

Project description


PyPI PyPI PyPI PyPI Telegram Code Style

tgcli is a Python cli app for Telegram.

Build Coverage
Master Travis (.com) master
Development Travis (.com) development


Install via pip:

pip install tgcli


A similar project, built on Python, was created by @vysheng, but it has not been updated since 2016 and considered abandoned. This tool is not a fork of the mentioned project, it is built from ground up.


For now, the use case is pretty simple. To send a message:

tgcli bot --token "BotToken" send --receiver "UserID" message "Your message"

You don't need to expose your token as flag. If you set TELEGRAM_BOT_TOKEN environment variable, you do not need to set --token flag. Just set it before using tgcli:

export TELEGRAM_BOT_TOKEN="BotToken"

You can get more information by doing:

tgcli bot send --help

Also, this repository uses notification from a private bot, you can see the example Travis configuration here. Private TELEGRAM_BOT_TOKEN and TELEGRAM_RECEIVER environment variables were set.

This application serves a really small purpose for now. It might face breaking changes in the future.


Documentation has an intensive amount of information about how to use tgcli. Refer to the documentation.


tgcli is a free (as in beer and speech) software that I have built in my leisure time and been maintaining it. If you like to use it, please consider a small donation.

How do I donate?

I accept donations in:

  • MiliBitcoin (mBTC)
  • Monero (XMR)

You can donate predefined (almost $1) or custom donation by clicking or scanning below.

Predefined (Almost $1) How Much You Wish
MiliBitcoin (mBTC) mBTC predefined mBTC custom
Monero (XMR) XMR predefined XMR custom

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 tgcli, version 0.3.1
Filename, size File type Python version Upload date Hashes
Filename, size tgcli-0.3.1.tar.gz (8.7 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page