Sopel is a simple, lightweight, open source, easy-to-use IRC Utility bot, written in Python. It's designed to be easy to use, run and extend.
Latest stable release
If you're on Arch, the easiest way to install is through your package
manager. The package is named
sopel in [community] repository. On other
distros, and pretty much any operating system you can run Python on, you can
install pip, and do
sopel. Failing all that, you can download the latest tarball from
https://sopel.chat and follow the steps for installing from the latest
First, either clone the repository with
git://github.com/sopel-irc/sopel.git or download a tarball from GitHub.
Note: sopel requires Python 2.7.x or Python 3.3+ to run. On Python 2.7,
backports.ssl_match_hostname to be installed. Use
pip install backports.ssl_match_hostname or
yum install python-backports.ssl_match_hostname to install it,
or download and install it manually from PyPi <https://pypi.python.org/pypi/backports.ssl_match_hostname>.
In the source directory (whether cloned or from the tarball) run
setup.py install. You can then run
sopel to configure and start the
bot. Alternately, you can just run the
sopel.py file in the source
The easiest place to put new modules is in
Some extra modules are available in the
sopel-extras repository, but of
course you can also write new modules. A tutorial
for creating new modules is available on the wiki.
API documentation can be found online at https://sopel.chat/docs, or
you can create a local version by running
make html in the
Join us in #sopel on Freenode.