Skip to content


Subversion checkout URL

You can clone with
Download ZIP
A modified version of Supybot (an IRC bot) with translations (fr, fi, it, hu, de, ...), embedded web server, IRCv3 support, and several other enhancements and bug fixes

Revert ban description-related commits.

Squashed commit of the following:

commit ea4743caa8bdc7abba99635898ae09a9497c43d3
Author: Valentin Lorentz <>
Date:   Sun May 24 01:07:49 2015 +0200

    Revert "Channel & core: Add support for ban descriptions. Closes GH-1092."

    This reverts commit 6efea56.


commit d43b9229fe926869852c4abda1da1b18a0093938
Author: Valentin Lorentz <>
Date:   Sun May 24 01:06:30 2015 +0200

    Revert "Fix import of channel database."

    This reverts commit 8ed5522.

commit 6c453d9acb3dc37711cb4d51abd9fe216ca65c08
Author: Valentin Lorentz <>
Date:   Sun May 24 01:06:27 2015 +0200

    Revert "Fix previous commit."

    This reverts commit 394f155.
latest commit f85395d8b1
@ProgVal authored
Failed to load latest commit information.
2to3 2to3/ Use UNIX new-line characters.
debian Use two different control files for Python 2 and 3.
locales Squashed commit of the following:
man remove docs/ && move manpages to man/
plugins Revert ban description-related commits.
sandbox Debug: move from sandbox/ to plugins/
scripts scripts/supybot: use %.2f for rounding
src Revert ban description-related commits.
test Improve order of connect messages.
.gitattributes Remove test from .gitattributes
.gitignore Update .gitignore to include default wizard directories & confs [ci s…
.mailmap Add myself to .mailmap [skip ci]
.travis.yml travis.yml: Add Python nightly.
ACKS Updated to be STX as well as ordered chronologically. CONTRIBUTING: add a paragraph about test cases and pull requests.
ChangeLog Use gender-neutral pronouns everywhere License: Fix formatting again. (GH-862) Add
Makefile Fix typo. README: Mention Limnoria supports CPython nightly.
RELNOTES supybot-botchk: Directly execute supybot instead of running it in sh
requirements.txt Recommend chardet instead of charade. Revert " Run refactoring in parallel."

Supybot is a robust (it doesn't crash), user friendly (it's easy to configure) and programmer friendly (plugins are extremely easy to write) Python IRC bot. It aims to be an adequate replacement for most existing IRC bots. It includes a very flexible and powerful ACL system for controlling access to commands, as well as more than 50 builtin plugins providing around 400 actual commands.

Limnoria is a project which continues development of Supybot (you can call it a fork) by fixing bugs and adding features (see the list of added features for more details).

Build status

Master branch: Build Status (master branch)

Testing branch: Build Status (testing branch)

Limnoria is tested with CPython 2.6, 2.7, 3.2, 3.3, 3.4, nightly; and Pypy 2 and 3. Python 2.5 and older versions are not supported.



If this is your first install, there is an install guide. You will probably be pointed to it if you ask on IRC how to install Limnoria.

There is extensive documentation at and at Gribble wiki. We took the time to write it; you should take the time to read it.

Installing from cloned repo

If you haven't cloned this repository, please see the previous two paragraphs for easier installation methods.

sudo pip install -r requirements.txt
sudo python install --user

alternatively without root

pip install -r requirements.txt --user
python install --user

IRC channels

In English

If you have any trouble, feel free to swing by #supybot and #limnoria on freenode or #supybot at OFTC (we have a Limnoria there relaying, so either network works) and ask questions. We'll be happy to help wherever we can. And by all means, if you find anything hard to understand or think you know of a better way to do something, please post it on the issue tracker so we can improve the bot!

In Other languages

Only in French at the moment, located at #supybot-fr on freenode.

Something went wrong with that request. Please try again.