Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Python Telegram Bots made easy

Project Description

Pytbo is a module aimed at simplifying the creation of Telegram Bots using Python.

A minimum familiarity with Telegram Bots is required to use this library. Please take a look at the introduction and the FAQ before starting.

Getting Started

To start working with Pytbo, you must have a Bot token. If you don’t know what we’re talking about, read how to create your first bot with BotFather.

This is a simple _echo_ bot done with Pytbo that looks for updates every 5 seconds.

import pytbo
import time

# Bot Token received from Telegram
# Polling interval in seconds

# Create bot object
bot = pytbo.BareBot(BOT_TOKEN)
# Print bot information
print("Bot ID......: %s" % (
print("Bot username: %s" % (bot.username))

# Initialize offset
offset = 0
# Infinite polling loop
while True:
    # Look for updates
    updates = bot.getUpdates(offset)
    # Handle them
    for u in updates:
        if u.message:
            if u.message.text:
                # If the update contains a message
                # that contains text, we reply to the
                # sender with the same text.
        # Update offset to avoid receiving
        # the same update again
        offset = u.update_id + 1
    # Sleep


To install Pytbo, simply:

$ pip install pytbo


A proper documentation is not yet available, but it will be. However, useful methods and classes are documented inside the source code.

Don’t be afraid to have a look inside, sometimes is the best way to learn.

How to Contribute

  1. Fork this repository on GitHub to start making your changes to the master branch (or branch off of it).
  2. Send a pull request.


Thanks to Kenneth Reitz and to all the other developers of the requests module, which is used inside Pytbo and also as a blueprint for this repository and documentation layout.

Release History

0.1.0 (2016-04-23)

  • BareBot class that wraps Telegram Bot APIs methods
  • Types classes that wraps Telegram Bot APIs types

0.0.1 (2016-04-14)

  • Conception

Release History

This version
History Node


Download Files

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

File Name & Hash SHA256 Hash Help Version File Type Upload Date
(19.9 kB) Copy SHA256 Hash SHA256
py2.py3 Wheel Apr 23, 2016
(16.7 kB) Copy SHA256 Hash SHA256
Source Apr 23, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting