An easy-to-use and highly extensible IRC Bot framework
Pull request Compare This branch is 1499 commits behind sopel-irc:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Willie is a simple, lightweight, open source, easy-to-use IRC Utility bot, written in Python. It's designed to be easy to use, run and extend.


The easiest way is to simply run install. Willie can also be run by copying scripts/willie to in the root of the source directory (i.e, the one with the scripts folder in it), and running that. You can also install the latest stable release of Willie through the Python Package Index by installing pip, and then running pip install willie. Willie is also available in the package repositories for Fedora 17 and 18.

Adding modules

The easiest place to put new modules is in ~/.willie/modules. You will need to add a a line to the [core] section of your config file saying extra = /home/yourname/.willie/modules.

Some extra modules are available in the willie-extras repository, but of course you can also write new modules. A tutorial for creating new modules is available on the wiki. API documentation can be found online at, or you can create a local version by running make html in the doc directory.

Further documentation

In addition to the official website, there is also a wiki which includes valuable infomration including a full listing of commands.


Contact us on channel #tech

For a list of contributions to the Jenni fork see the file CREDITS.