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

Download files

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

Source Distribution

thebot-0.4.0.tar.gz (30.1 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page