=========================== OTFBot - The friendly Bot
.. contents:: .. sectnum::
For the core functionality are a python interpreter and the following modules necessary. Currently version 2.6 of cPython is used to develop the bot. If you are encountering problems with other versions of python please file a bug.
OTFBot is build around the twisted framework, so you need this with a
version of 9.0.0 or newer as well. Currently the the
web modules are used (Debian packages
As the configuration is stored in a yaml-file, you need the python-bindings
for yaml. libyaml 0.1.1 and python-yaml 3.05 are tested and working.
If you intend to use a encrypted connection you need also
Some plugins require additional modules. You'll need
quotesfromweb, python-xmltv_ for
svn, python bindings for megahal for
xmppClient needs wokkel_. Debian has a package python-wokkel for it.
for building the needed modules from pypi with easy_install you need on debian: build-essential libssl-dev python-dev python-setuptools
Note: if installed via pypi, the logging may behave a bit strange at the start. this is a known issue and does not make any trouble except a few very long lines at start of the log. see http://www.otfbot.org/bugs/index.php?do=details&task_id=95
If you installed the bot as root (i.e. via easy_install), run once "twistd --help" as root. This avoids error messages because dropin.cache cannot be written. If you cannot do this, because the bot is installed by root and you're only having user priviledges, just ignore the error messages, the bot will run fine nevertheless.
To create a initial configuration for connecting to a network, joining a channel and creating a superuser, run
twistd gen-otfbot-config -c otfbot.yaml
from the root directory of the bot and answer the questions.
Review the config and adjust some settings as necessary. Do not modify the configuration while the bot is running, as it will be overwritten while the bot shuts down.
The bot is launched via twisteds
twistd otfbot -c otfbot.yaml
twistd lets you also specify the user and group and some other settings.
Be aware that the logging is configured via otfbot.yaml and not via twistd.
Running the bot as root is neither needed nor supported. in fact it will not
even start as root, but give you an error.
OtfBot is very easy extendable by developing your own plugins. Just have a look at example/example.py. All Callbacks are listed in this file. If you aren't sure what a specific callback does, just copy the plugin to otfbot/plugins/ircClient/, add it to config and start otfbot to test it.
If you have finished follow the steps to enable a plugin above. If you think your plugin is of general interest, you are welcome to contact us to include it into the repository.
You can contact the developers via IRC in #otfbot at irc.freenode.net, via a mailing-list_ or by filing a bug into the bug-tracker_
.. _python-xmltv: http://www.funktronics.ca/python-xmltv/ .. _mailing-list: http://list.otfbot.org/mailman/listinfo/otfbot-dev .. _bug-tracker: http://www.otfbot.org/bugs/ .. _wokkel: http://wokkel.ik.nu/downloads