Go to file
Valentin Lorentz 3576503e3f Update links to the documentation. 2020-03-17 19:22:52 +01:00
locales Config docs: remove reference to grouped nicks 2020-02-08 11:07:19 +01:00
man remove docs/ && move manpages to man/ 2014-12-08 09:52:42 +02:00
plugins RSS: If ids are missing, use <link> as id. 2020-01-31 20:59:42 +01:00
sandbox Remove fix_basestring. 2015-08-10 20:24:11 +02:00
scripts scripts: remove obsolete conditionals for Python 2 2020-01-05 11:31:45 -08:00
src Update links to the documentation. 2020-03-17 19:22:52 +01:00
test Replace failUnless/failIf with assertTrue/assertFalse. 2020-01-26 11:14:18 +01:00
.gitattributes Remove test from .gitattributes 2015-03-04 00:32:40 -05:00
.gitignore Revert changes to the structure of sdist packages. 2019-02-23 00:12:06 +01:00
.mailmap update mailmap with a few more emails to correctly merge the right commits 2017-10-28 18:17:49 -04:00
.travis.yml .travis.yml: fix indent 2020-01-25 00:12:31 +01:00
CONTRIBUTING.md Fix broken links in CONTRIBUTING.md. 2019-01-02 14:32:22 +01: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
MANIFEST.in Explicitly include test/ in release tarballs. Closes GH-1384. 2019-10-28 18:17:13 +01:00
Makefile Add a symlink supybot pointing to src/ + move locales/ to src/ 2019-01-02 14:29:32 +01:00
README.md Update links to the documentation. 2020-03-17 19:22:52 +01:00
RELNOTES supybot-botchk: Directly execute supybot instead of running it in sh 2013-08-23 21:42:01 -04:00
requirements.txt Rewrite ecdsa-nist256p-challenge using python-cryptography instead of python-ecdsa. 2020-01-01 12:07:59 +01:00
setup.py setup.py: migrate shebang to Python 3 2020-01-05 11:35:00 -08:00
supybot Add a symlink supybot pointing to src/ + move locales/ to src/ 2019-01-02 14:29:32 +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 the project which continues development of Supybot since 2010.

Build status

Master branch: Build Status (master branch)

Testing branch: Build Status (testing branch)

Limnoria supports CPython 3.4, 3.5, 3.6, 3.7, nightly; and Pypy 3.

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. TL;DR version:

sudo apt-get install python3 python3-pip python3-wheel
pip3 install --user limnoria
# You might need to add $HOME/.local/bin to your PATH
supybot-wizard

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

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.