A robust, full-featured, and user/programmer-friendly Python IRC bot, with many existing plugins. Successor of the well-known Supybot.
Go to file
Valentin Lorentz 06c88581ec Services: Improve error on missing password or NickServ nick 2023-11-18 22:02:36 +01:00
.github/workflows Skip irctest on Python 3.7 2023-09-24 19:55:57 +02:00
locales all: Update .pot and .po files 2022-02-06 00:14:47 +01:00
man Add alternative name 'limnoria-' in addition to 'supybot-*' for scripts 2022-06-17 11:48:27 +02:00
plugins Services: Improve error on missing password or NickServ nick 2023-11-18 22:02:36 +01:00
sandbox sandbox/update_pot.py: Run msgmerge as well 2022-02-06 00:12:42 +01:00
src Fix recursive loop in limnoria_reset_password 2023-10-24 20:05:18 -07:00
test Ignore trailing whitespace when addressing the bot by nick at end (#1563) 2023-10-08 19:07:08 +02:00
.editorconfig .editorconfig: only apply indent_size and line_length for *.py 2023-09-29 11:43:04 +02:00
.gitattributes .gitattributes: enable EOL normalization 2023-09-29 11:43:04 +02:00
.gitignore .gitignore: add doc-* paths from supybot-plugin-doc 2022-07-09 14:15:33 -07:00
.mailmap .mailmap: update my email 2020-05-15 11:28:09 -07: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 Remove Travis badges 2021-11-19 09:53:31 +01:00
RELNOTES supybot-botchk: Directly execute supybot instead of running it in sh 2013-08-23 21:42:01 -04:00
pyproject.toml Geography: run Black 2021-11-09 22:41:40 +01:00
requirements.txt requirements.txt: add ddate as an optional dependency for Time.ddate 2023-09-29 11:23:16 +02:00
setup.py setup.py: Add Python 3.11 and 3.12 to classifiers. 2023-05-21 18:50:24 +02:00
supybot Add a symlink supybot pointing to src/ + move locales/ to src/ 2019-01-02 14:29:32 +01:00

Limnoria is a multipurpose Python IRC bot, designed for flexibility and robustness, while being easy to install, set up, and maintain.

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, an equality powerful configuration system to customize your bot, as well as more than 60 builtin plugins providing around 400 actual commands.

There are also dozens of third-party plugins written by dozens of independent developers, and it is very easy to write your own with only basic knowledge of Python.

It is the successor of Supybot since 2010 and provides many new features, but keeps full compatibility with existing configurations and plugins.



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

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 #limnoria on Libera.Chat 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 #limnoria-fr on Libera.Chat.