Table of Contents

  1. Downloads
  2. Background
  3. Requirements
  4. Dependencies
  5. Configuration
  6. Running
  7. Built-In Commands
  8. Extending Commands
  9. Background

ImBotShell, an easily extended IM chatbot

Downloads

The latest version of files, with possible corrections or additions, can be seen here:

Background

I'd like an instant messaging bot that's about as easy to extend as dropping a CGI script into a web server directory. Maybe this bot will do that.

If you check at just the right times, decafbot@jabber.org may be running a version of this bot.

Requirements

Here's what you need to run this beast:

  • A UNIX-ish OS (I use OS X and Debian)
  • Python 2.4.3 (mine came from DarwinPorts? under OS X)

Dependencies

Code from the following projects is used in this beast:

There's no need to download these packages at present, since they are bundled under the lib/ directory.

Configuration

In the conf/ directory, find imbotshell.conf. Someday, this file will have proper documentation - but for now, you can supply a JID / username and password for Jabber and AIM transports in the appropriate locations.

You can also disable the Jabber or AIM transport by taking one or the other out of the transports list in the [main] section.

Running

You should be able to start this thing up simply by running the run.py script in the root of the package, like so: 

    python run.py

Built-In Commands

TODO

Extending Commands

TODO

Background

...