An IRC bot and plugin system for the #cs-york channel on
Latest commit 3320c10 Mar 25, 2017 @alanbriolat alanbriolat committed on GitHub Merge pull request #121 from BenSimner/master
Add tests for whois plugin


csbot - an IRC bot

This is an IRC bot developed by members of HackSoc to provide various features in the #cs-york channel on Freenode.


csbot is written for Python 3.4 and based on the asyncio library which became part of the Python standard library in 3.4. It may also work on Python 3.3 with the asyncio package installed, but this is currently untested.

It's recommend to develop within a virtual environment. This should get you up and running [1]:

$ virtualenv -p python3 venv3
$ source venv3/bin/activate
$ pip install -r requirements.txt
$ ./ --help

Look at csbot.deploy.cfg for an example of a bot configuration.

If you want to develop features for the bot, create a uniquely named plugin (see csbot/plugins/ for examples), try it out, preferably write some unit tests (see csbot/test/plugins/) and submit a pull request.


The code is documented to varying degrees, and Sphinx-based documentation is automatically generated on Read the Docs: Of particular use is the "How to write plugins" section.

You can build the documentation yourself with:

$ pip install sphinx
$ cd docs/
$ make html


csbot has some unit tests. (It'd be nice to have more.) To run them:

$ ./

We're also using Travis-CI for continuous integration and continuous deployment.
[1]csbot depends on lxml, which is a compiled extension module based on libxml2 and libxslt. Make sure you have the appropriate libraries and headers, e.g. python3-dev, libxml2-dev and libxslt1-dev on Ubuntu or Debian.