Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

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](
Release History

Release History

This version
History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
berend-0.4.tar.gz (6.4 kB) Copy SHA256 Checksum SHA256 Source May 28, 2014

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting