Contents

Python 3.3 or newer is required; having at least Python 3.4 is recommended. When installing Python on Windows, ensure that you select "Add Python to PATH" on the installer screen.

The pip program to install Python packages is recommended. If you do not have it, you will need to download and install the dependencies yourself, which is not covered in this guide.

Installing Git is recommended. You cannot use various commands (such as !update) without Git.

Familiarity with IRC and the Operating System you are installing lykos on is required. You will need to be comfortable running things in a terminal/command line environment, and you will need to know core things about IRC such as what commands are used to authenticate with Services (if any) and what channel modes are. If this doesn't describe you, then we recommend that you do not run lykos.

Go to the folder you want to download your instance of lykos. Do not create a separate folder for it, Git will do that by itself. Right click and select "Git Bash Here" from the drop-down menu that appears. In the window that opens, type the following command and press enter. It may take some time, do not close the window or proceed onwards until you see a prompt again (a blinking cursor with a $ in front of it).

git clone https://github.com/lykoss/lykos

Once the above command is complete and you see the prompt again, Git has finished downloading the files and put them into a new folder called "lykos." Run the following commands, pressing enter after each one. The second command may take a while again. Once you finish running every command (the prompt appears again), you can close the window.

At a minimum in order to run lykos, you will need to create a botconfig.py file. We supply a botconfig.py.example file that you should copy to your botconfig.py to get a mostly-working configuration. You will need to further modify that file to include the server connection details and bot nickname and password. Depending on what IRC network you are connecting to, you may need to configure other things as well. We provide a sample configuration for Undernet as an example of how to do that. For further assistance in configuring the bot, see the configuration article.

Important: Do not modify any files in the src or messages directories, it will make updating the bot significantly more difficult and you will be unable to receive official support for the bot! A great amount of customization can be made without needing to modify any of those files.