A Flexible Boilerplate Framework for discord.py. Initialise a production-ready Discord bot in just 4 lines of code with automated command syncing, preconditions, and built-in diagnostics.
import discord
from dopamineframework import Bot
# Initialize production bot in seconds
bot = Bot(
command_prefix="?",
cogs_path="cogs",
default_diagnostics=True,
intents=discord.Intents.default()
)
bot.run("YOUR_BOT_TOKEN_HERE")Here's what we have to offer to improve your Discord bot development experience.
A registry that compares local command states with remote Discord API states. Ensures commands are only synced when changes are detected, preventing rate limits.
Use @dopamine_commands.command to define permissions and global cooldowns in a single line. Comes with built-in presets like 'moderator' and 'manager'.
Manage your bot directly from Discord using /od. Unload/reload cogs on the fly, restart the bot, and check real-time log files without SSH access.
Real-time monitoring of API latency, CPU/RAM utilization via psutil, and latency graphs to ensure your bot scales securely.
A robust logging manager utilizing aiosqlite ready to be plugged into your custom systems for mod logs, action records, and audits.
Built-in UI helpers that restrict interaction on buttons and dropdowns exclusively to the user who initiated the slash command.
How we stack up against bare-bones discord.py and the most popular JS framework: Sapphire Framework.
| Feature | Dopamine Framework | Sapphire (JS/TS) | Bare discord.py |
|---|---|---|---|
| Easy Setup (Minimal Boilerplate) | ✔ | ✘ | ✘ |
| Smart Commands Sync | ✔ Built-in |
✔ Plugin |
✘ |
| Preconditions / Role Presets | ✔ | ✘ | ✘ |
| In-Discord Dashboard | ✔ Built-in |
✘ | ✘ |
| Built-in Resource Monitoring | ✔ | ✘ | ✘ |
| Fast Iteration | ✔ | ✘ | ✘ |