Skip to main content

Extensible IRC bot

Project description


Berend is a Twisted IRC bot with SSL-support. If you use this module,
you will not have to write any of the boilerplate and instead can
focus on programming the behavior of your bot.

If you use SSL, there is no certificate checking so beware!


To build a bot you need to write a bot config file (yaml) and some
plugins (simple python modules).

The default config file berend will look for is `berend.yaml`. If you
want to use a different config file, then you need to set the
`BEREND_CONFIG` environment variable to its path.

An example bot config file is included in the distribution and looks
like this:


ssl: true
port: 6697
- berend-botje-test
nickname: berend
realname: Berend Botje
# on_connect is a list of raw commands sent to the server on connect,
# use this to identify for example:
# on_connect:
# - "PRIVMSG NickServ :identify berend secret"

Add your plugins to the bottom. The key is the importable,
dot-separated python module name, the value is passed on to your
plugin's setup method. Look at the help plugin for a fully documented

An example plugin looks like this:


def setup(bot, config):
bot.respond('hello', hello, ('hello', 'force bot to greet you'))

def hello(bot, user, channel, msg, matches):
bot.reply(user, channel, 'hello to you %s' % user)

See Also

The bot is a Twisted IRC client. Check out the [Twisted documentation]( and the [ircLogBot example]( for more information.

Oh and of course: [Berend Botje](

Project details

Download files

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

Files for berend, version 0.4
Filename, size File type Python version Upload date Hashes
Filename, size berend-0.4.tar.gz (6.4 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page