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
sudo apt-get install python-pip in a terminal. For OSX and Windows,
follow PIP's setup instructions
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
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
The latest version of Sopel is available
here. Download it, and
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
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.