IslamBot is an open-source Discord bot that provides several utilities useful for the study and practice of Islam. Features include:
Instructions on how to use the bot are available on the wiki.
The Python packages required to run the bot are listed in requirements.txt file. Options are retrieved from a file named config.ini
in the base directory. An example config.ini
can be found here.
To run the bot, you will need to exclude the TopGG extension from loading. It is recommended to only sync commands with your test server to avoid falling afoul of Discord's strict rate limits on global command synchronisation. Please consult the comments in main.py for more information.
You can use the /reload
command to reload extensions and commands while the bot is running. If you have made a change to a command, reload its extension first before reloading commands.
If you lack a sunnah.com API key, you may use the demo key provided in the API documentation for testing. Be aware that this key has a low request limit.