Skip to main content


Project description

This is a general purpose chat bot, extensible in varios ways. The reason, why it was written is because NodeJS and CoffeeScript are sucks and Hubot uses them.

The Bot is written in orthodox Python and can be installed via pip. It’s functionality can be extended by installation of additional python packages, you don’t have to clone a repository and hack some code there.



virtualenv env
source env/bin/activate
pip install 'git+git://'

To connect TheBot to the IRC channel do:

thebot --adapter irc --irc-host --irc-channels somechannel --irc-nick thebot

To turn on more useful plugins, install them via pip. For example, to install Instagram and Github plugins, do:

pip install 'git+git://'
pip install 'git+git://'
thebot --adapter irc --plugins instagram --irc-host --irc-channels somechannel --irc-nick thebot

Then, join this channel and send thebot, instagram on message. To list all supported command, issue the message thebot, help.

Available adapters



  • Be the first, who will write the one!

Available plugins


  • image — uses Google Image and, to search images and to make them funny.
  • math — uses Google Calculator to do some math and convert currencies.
  • todo — a simple task manager which will store your tasks and send you reminders.


  • github — allows to track new issues, pull requests and comments.
  • instagram — posts new popular images from Instagram.
  • translate — translates texts from one language to another.
  • pomodoro — powerful pomodoro timer to boost your productivity.
  • draftin — accepts callbacks from and runs a shell command to publish post into the static generated blog.
  • webhooks — configurable webhooks, to run any number of commands on HTTP POST or GET requests.
  • Add yours plugins to this list!


There are some bots written in Python, but all of them sucks, because, most of the works only with IRC and none of them has such beautiful architecture as The Bot.

But if you still have some doubts, here is a list of some bots. Go, try them and come back to ask The Bot to forgive you treason.


  • Implement method create_request in irc and xmpp adapters, to be able to use them as a notification channel in the thebot-webooks plugin.

Project details

Release history Release notifications

History Node


This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
thebot-0.4.0.tar.gz (30.1 kB) Copy SHA256 hash SHA256 Source None Jun 10, 2014

Supported by

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