Installing Limnoria on GNU/Linux and UNIX (FreeBSD, macOS, …)

This is the “easy to follow” guide to installing Limnoria.

This guide is for non-Windows operating systems. If you want to install on Windows, check out the Windows install guide.

Install

Install using your OS’ package manager

  • Debian or Ubuntu: sudo apt-get install limnoria

    Note that stable / LTS releases may not have the latest features or bug fixes for Limnoria. If you want a newer version than what’s in the default repositories, you can enable Backports on Debian or Unit 193’s PPA on Ubuntu.

  • Fedora: sudo dnf install limnoria

  • CentOS and Red Hat Enterprise Linux: you have to first add the right EPEL repository for your CentOS/RHEL version before being able to install the package on CentOS / RHEL. Once you have, you can run the following command to install Limnoria: sudo yum install limnoria

  • Arch Linux: You can install Limnoria from the AUR, using either limnoria (stable releases) or limnoria-git (git snapshots).

  • Gentoo: sudo emerge net-irc/limnoria

  • Guix and GuixSD: guix package --install limnoria

If any of the methods above works for you, skip the next section and go to Configuration.

Other operating systems (manual install)

If you followed the section above, skip this one.

Dependencies

We require at least Python 3.9, and recommend using the latest Python stable release available for your OS.

You may also install chardet and feedparser, which are used by Limnoria if they are available.

Install Python

Python will usually come by installed by default in your distribution. If not, grab the appropriate packages from the distribution’s repository, or download it from https://python.org.

Install Limnoria

In the next section of this guide we will use pip, which is a generic way of installing Python software.

First, you need to setup a virtualenv, which is the directory where we will install Limnoria’s code (but not its configuration):

mkdir -p $HOME/.venvs/
python3 -m venv $HOME/.venvs/limnoria  # creates a virtualenv at the given path
. $HOME/.venvs/limnoria/bin/activate   # enables the virtualenv in the current shell

Install Limnoria’s optional dependencies (you can skip this step, but some features won’t be available):

pip install -r https://raw.githubusercontent.com/progval/Limnoria/master/requirements.txt --upgrade

Then Limnoria itself:

pip install limnoria --upgrade

Add the virtualenv’s bin directory to your PATH, so your shell knows where to find Limnoria:

echo 'PATH="$PATH:$HOME/.venvs/limnoria/bin"' >> ~/.$(echo $SHELL|cut -d/ -f3)rc
source ~/.$(basename $SHELL)rc

Configuration

Note

For historical reasons, commands are called supybot; but they actually run Limnoria.

We are now ready to configure Limnoria. Limnoria creates quite a few auxiliary files/directories to store its runtime data. It is thus recommended to create an empty directory from which you’ll be running Limnoria, to keep all the data in a nice dedicated location. For example, you may create a ‘runbot’ directory inside your home directory.

Now you can cd to your ‘runbot’ directory, and from within it run supybot-wizard, which will walk you through a series of questions to generate the bot config file.

One thing to make sure to do in the wizard, to make your life easier down the line, is to select y for the Would you like to add an owner user for your bot? question, and actually create the owner user. Remember that password, so that you can later ‘’identify’’ with the bot on IRC and administer it.

Once you generate the config file, which will be named yourbotnick.conf (where “yourbotnick” is the nick you have chosen for your bot in the wizard), it will be placed in your ‘runbot’ directory. (As long as you leave the default answer to the ‘’Where would you like to create these directories?’’ question.)

Now to start the bot, run, still from within the ‘runbot’ directory:

supybot yourbotnick.conf

And watch the magic!

For a tutorial on using and managing the bot from here on, see the Getting Started guide.