Installation
From PyPI
Installing from PyPI is the best way to install Sopel, since it'll handle installing all of the extra stuff you need to run all of the modules properly.
Sopel works on both Python 2 and Python 3. If you're planning on using Python 3 with CentOS, you may want to see this guide on getting that set up easily.
You will need to have pip installed. On Debian and Ubuntu, you can do this by
running sudo apt-get install python-pip
in a terminal. For OSX and Windows,
follow PIP's setup instructions
here.
Once you have pip set up, just do sudo pip install willie
(until 6.0 is
released, whence it will be sudo pip install sopel
). If you get an
error about lxml (or, probably, any other big messy looking error), it's
beacuse pip
is having problems installing lxml
, which some modules depend
on. You're best off installing python-lxml
from your package repos and trying
again. If you can't for some reason (you're using a virtualenv or alternate
python, you don't have root access, you're on Windows), follow their
instructions here.
Manual installation
The latest version of Sopel is available
here. Download it, and
run python setup.py install
. You will need to download all of Sopel's
dependencies and install them manually as well. These can be found on the
Python Package Index. The only one that's
needed for the bot itself to work is
backports.ssl_match_hostname
Other things are needed for modules to work properly. If you get errors about
being unable to import modules when you start the bot, search for them on PyPI.