Skip to content

A robust, full-featured, and user/programmer-friendly Python IRC bot, with many existing plugins.

License

Notifications You must be signed in to change notification settings

progval/Limnoria

Folders and files

NameName
Last commit message
Last commit date
Dec 20, 2024
Mar 17, 2025
Jun 17, 2022
Mar 17, 2025
Feb 5, 2022
Dec 20, 2024
Nov 30, 2024
Sep 29, 2023
Sep 29, 2023
Jul 9, 2022
May 15, 2020
May 5, 2024
Jul 13, 2014
Sep 22, 2014
Oct 28, 2019
Jan 2, 2019
Nov 19, 2021
Aug 24, 2013
Nov 9, 2021
Sep 29, 2023
Oct 19, 2024
Jan 2, 2019

Repository files navigation

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.

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 #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.