Akrasia is a framework for writing and self-hosting Discord bots in Python. It is based on discord.py, and uses the same underlying classes, but implements command aliases, audit logging, database integration via SQLAlchemy, and easily adding groups of custom commands ("modules"). It comes with pre-installed modules for quotes, role management, and reminders.
The bot is designed with self-hosting in mind, and includes simple tools for adding your own commands and interaction with a database (either in memory, on disk, or remote). These short guides can walk you through setting up your own instance and adding custom commands:
- Getting started
- Adding commands (assumes basic knowledge of Python syntax)
A short atlas of pre-installed commands is below. You can find out more by running !help [command-name].
Allows admins to add commands that redirect to existing commands, optionally with arguments.
Commands:
!addalias [old command] [new alias]to add an alias!deletealias [alias]to delete an alias!aliasesto list all aliases
Stores a recreation of specified messages as a quote.
Commands:
!quoteto add quotes!deletequoteto delete quotes!getquote [search term]to show a random quote with a given term or user!getquotes [search term]to show all quotes with a given term or user
Tell the bot to remind you of something after a given time period, or on a given day.
Commands:
!remindme [time until reminder] [message]to set a reminder that fires in 5 seconds, 10 minutes, etc.!remindersto list all your reminders in PM!deletereminder [identifier]to delete one of your reminders by text or ID
Allows admins to add or delete roles, and all users to join or leave them.
Commands:
!addrole [role name]to make a role !joinable (adds it to the server if it doesn't exist)!deleterole [role name]to delete a role from the server!unlistrole [role name]to make a role un-!joinable again without deleting it!join [role name]to join a !joinable role!leave [role name]to leave any role
!help and !echo.
Commands:
!helpwill list all commands on the bot!help [command name]will display specific instructions for the command!echo [channel] [message]will echo a message to a channel (can only be run by bot owner at the moment)