Limnoria/INSTALL.md
2012-05-06 18:23:05 +03:00

3.6 KiB
Raw Blame History

Common

First things first: Supybot requires at least Python 2.6. There aint no getting around it. You can get it from http://www.python.org/.

Recommended Software

PySQLite -- Version 2.x

Twisted -- Version 1.2.0 or greater

For more information and help on how to use Supybot, checkout the documents under docs/ (especially GETTING_STARTED and CONFIGURATION).

So what do you do? That depends on which operating system youre running. Weve split this document up to address the different methods, so find the section for your operating system and continue from there.

UNIX/Linux/BSD

If youre installing Python using your distributors packages, you may need a python-dev package installed, too. If you dont have a /usr/lib/python2.x/distutils directory or /usr/lib/python2.x/config/Makefile (assuming /usr/lib/python2.x is where your Python libs are installed), then you will need a python-dev package.

After you extract Supybot and cd into the supybot directory just created, youll want to run (as root) python setup.py install. This will install Supybot globally. If you need to install locally for whatever reason, see the notes at the end of this section. Youll then have several new programs installed where Python scripts are normally installed on your system (/usr/bin or /usr/local/bin are common on UNIX systems). The two that might be of particular interest to you, the new user, are supybot and supybot-wizard. The former, supybot, is the script to run an actual bot; the latter, supybot-wizard, is an in-depth wizard that provides a nice user interface for creating a registry file for your bot.

Local Install

You can install Supybot in a local directory by using the user option when running setup.py. E.g., python setup.py install user to install into your home directory. Youll now have a $HOME/.local/bin directory containing Supybot programs (supybot, supybot-wizard, etc.) and a $HOME/.local/lib directory containing the Supybot libraries.

Windows

Note: If you are using an IPV6 connection, you will not be able to run Supybot under Windows (unless Python has fixed things). Current versions of Python for Windows are not built with IPV6 support. This isnt expected to be fixed until Python 2.4, at the earliest.

Now that you have Python installed, open up a command prompt. The easiest way to do this is to open the run dialog (Programs -> run) and type “cmd” (for Windows 2000/XP/2003) or “command” (for Windows 9x). In order to reduce the amount of typing you need to do, I suggest adding Pythons directory to your path. If you installed Python using the default settings, you would then do the following in the command prompt (otherwise change the path to match your settings)::

set PATH=C:\Python2x\;%PATH%

You should now be able to type python to start the Python interpreter. Exit by pressing CTRL-Z and then Return. Now that thats setup, youll want to cd into the directory that was created when you unzipped Supybot; Ill assume you unzipped it to C: for these instructions. From C:, run python setup.py install. This will install Supybot under C:2x'. You will now have several new programs installed in C:2x'. The two that might be of particular interest to you, the new user, are supybot and supybot-wizard. The former, supybot, is the script to run an actual bot; the latter, supybot-wizard, is an in-depth wizard that provides a nice user interface for creating a registry file for your bot.