Go to file
Valentin Lorentz 13c411b741 Improve README. 2015-11-29 18:04:06 +00:00
debian Use two different control files for Python 2 and 3. 2015-05-20 21:09:00 +02:00
locales Squashed commit of the following: 2014-12-20 14:37:27 +01:00
man remove docs/ && move manpages to man/ 2014-12-08 09:52:42 +02:00
plugins Web: Fix title fetching. 2015-11-29 17:59:57 +00:00
sandbox Remove fix_basestring. 2015-08-10 20:24:11 +02:00
scripts supybot-test: Use absolute path for directories. 2015-09-20 15:45:43 +02:00
src Merge pull request #1193 from GLolol/fix-disconnects 2015-11-19 08:01:27 +01:00
test Make normalizeWhitespace remove \r as well. 2015-08-30 15:44:07 +02:00
.gitattributes Remove test from .gitattributes 2015-03-04 00:32:40 -05:00
.gitignore Update .gitignore to include default wizard directories & confs [ci skip] 2014-11-20 17:43:57 -08:00
.mailmap Add myself to .mailmap [skip ci] 2014-12-08 22:00:37 -08:00
.travis.yml .travis.yml: Allow failures on Pypy3. 2015-08-30 15:55:26 +02:00
ACKS Updated to be STX as well as ordered chronologically. 2005-01-19 23:39:52 +00:00
CONTRIBUTING.md CONTRIBUTING.md: Fix grammar 2015-05-24 23:29:26 +02:00
ChangeLog Use gender-neutral pronouns everywhere 2014-07-13 17:23:11 +02:00
LICENSE.md License: Fix formatting again. (GH-862) 2014-09-22 05:27:09 +00:00
Makefile Fix typo. 2015-05-23 11:36:40 +02:00
README.md Improve README. 2015-11-29 18:04:06 +00:00
RELNOTES supybot-botchk: Directly execute supybot instead of running it in sh 2013-08-23 21:42:01 -04:00
requirements.txt Recommend chardet instead of charade. 2015-04-29 10:07:49 +02:00
setup.py setup.py: Improve/update classifiers. 2015-11-11 10:08:09 +01:00

README.md

Supybot is a robust (it doesnt crash), user friendly (its 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 supports CPython 2.6, 2.7, 3.2, 3.3, 3.4, 3.5, nightly; and Pypy 2 and 3. It works best with CPython 3.3 and higher. Python 2.5 and older versions are not supported.

Support

Documentation

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 supybot.aperio.fr 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 dont want to clone the repo, please see the previous two paragraphs for easier installation methods.

git clone https://github.com/ProgVal/Limnoria.git
sudo pip install -r requirements.txt
sudo python setup.py install --user

alternatively without root

git clone https://github.com/ProgVal/Limnoria.git
pip install -r requirements.txt --user
python setup.py 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. Well 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.