home • contact • thpinfo.com

2007 / python-jabberbot: A simple Jabber Bot for Python

jabberbot: A simple Jabber Bot for Python

Programming your own Jabber bot can be fun and helpful. This is python-jabberbot, a Jabber bot framework for Python that enables you to easily write simple Jabber bots. You can use your Jabber bots to provide information about your running systems, to make your website interact with your visitors or notify you about updates or changes you monitor with your Python scripts.

[...] now I have the 'bot bug' and I want to write bots for all kinds of things, since it's so easy to do. Thanks again!

This Jabber bot is partly inspired by the xmpppy example bot.py, but designed to be re-usable and to make it easy to write small Jabber bots that do one thing and do it well.

License: GNU General Public License, Version 3 or later (GPLv3)

Dependencies

Documentation

Debian Package

Thanks to Carl Chenet, python-jabberbot is now available as a Debian package for easy installation on Debian and derived systems:

Download

Development repository (Git)

You can get the latest and greatest code via Git:

git clone git://repo.or.cz/jabberbot.git

Release history

  • 2007-07-28: Initial release
  • 2007-09-17: Merged patch from John Martinez
  • 2007-10-19: Merged patch from Dan Sanders
  • 2008-07-12: Add setup.py, prepare for CheeseShop, tarball
  • 2008-11-26: Add TwitterBot example
  • 2009-01-25: Fix dependency checking
  • 2009-11-01: JabberBot 0.7 released with patches from Pat Notz
  • 2009-11-06: JabberBot 0.8 released (fixed code examples on website + examples/ in the source)
  • 2009-12-23: JabberBot 0.9 released (better help display; adding missing COPYING file)

The current ChangeLog can always be found on repo.or.cz/w/jabberbot.git and the old ChangeLog is still available.

Usage

  1. Import the class: from jabberbot import JabberBot, botcmd
  2. Subclass the JabberBot class
  3. Add methods and decorate them with "@botcmd". The signature of the methods should look like this: def somecommand(self, mess, args) - the methods should return the message sent back to the user as string (or None if the command gives no reply)
  4. Create an instance of your bot, supplying username and password
  5. Call the serve_forever() method of your instance
  6. You can call the send() method on your bot to send messages to specific users

Example code

from jabberbot import JabberBot, botcmd
import datetime

class SystemInfoJabberBot(JabberBot):
    @botcmd
    def serverinfo( self, mess, args):
        """Displays information about the server"""
        version = open('/proc/version').read().strip()
        loadavg = open('/proc/loadavg').read().strip()

        return '%s\n\n%s' % ( version, loadavg, )
    
    @botcmd
    def time( self, mess, args):
        """Displays current server time"""
        return str(datetime.datetime.now())

    @botcmd
    def rot13( self, mess, args):
        """Returns passed arguments rot13'ed"""
        return args.encode('rot13')

    @botcmd
    def whoami( self, mess, args):
        """Tells you your username"""
        return mess.getFrom()
 
username = 'my-jabberid@jabberserver.example.org'
password = 'my-password'
bot = SystemInfoJabberBot(username,password)
bot.serve_forever()

More examples

Starting with version 0.7, more examples can be found in the examples/ subdirectory of the source distribution.

Screenshot

Screenshot

Related projects

Yoan Blanc has done a similiar project using Python and the Twisted framework: A IM bot as an user interface (kind of).

Projects using python-jabberbot

Sunday, November 1st 2009