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
On most systems where you can run Python, the best way to install Sopel is to
install pip and then
pip install sopel.
Arch users can install the
sopel package from the [community] repository,
though new versions might take slightly longer to become available.
Failing both of those options, you can grab the latest tarball from GitHub and follow the steps for installing from the latest source below.
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.
Note: Python 2.x is near end of life. Sopel support at that point is TBD.
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
Sopel leverages SQLAlchemy to support the following database types: SQLite,
MySQL, PostgreSQL, MSSQL, Oracle, Firebird, and Sybase. By default Sopel will
use a SQLite database in the current configuration directory, but alternative
databases can be configured with the following config options:
db_filename (SQLite only),
db_name. You will need to manually install
any packages (system or
pip) needed to make your chosen database work.
The easiest place to put new modules is in
~/.sopel/modules. Some newer
modules are installable as packages; search PyPI for these. Many more modules
written by other users can be found using your favorite search engine.
Some older, unmaintained modules are available in the
sopel-extras repository, but of
course you can also write your own. A tutorial
for creating new modules is available on Sopel's website.
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.
This project exists thanks to all the people who contribute! Become a contributor.
Thank you to all our backers! Become a backer.
Support Sopel by becoming a sponsor. Your logo will show up here with a link to your website. Become a sponsor.