This release is a pre-release and may not be stable for production use.
Discord Bot Maker
Make a Discord bot with a few readable Python functions. Discord Bot Maker handles command registration, typed slash options, responses, buttons, permissions, cooldowns, saved data and background tasks.
from discord_bot_maker import Bot, CommandContext, Embed
bot = Bot.from_env()
bot.reply("hello", Embed("Hello, {{user.display_name}}!", "Welcome to {{server.name}}."))
@bot.command(description="Give yourself a point")
def point(ctx: CommandContext):
return f"You have {ctx.user_store.increment('points')} points."
bot.run(sync=True)
No subclass, command tree, interaction response plumbing, or database setup is needed for this example. Sponge demonstrates the package as a real bot, including a pet duck, saved snack counts, server settings, polls and restart-safe reminders. Sponge's personality lives in its script; the library is reusable for any bot.
The prepared release is 2.0.0a1, the first v2 prerelease. The project uses Python 3.15.0; the package declares Python 3.10+. Sponge has connected and synchronized its expanded command set live; automated tests cover the authoring features offline. More live feature testing is welcome.
Run Sponge
The current checkout already has a virtual environment. Put these in .env:
DISCORD_BOT_TOKEN=your_bot_token
DISCORD_GUILD_ID=your_server_id
DISCORD_CHANNEL_ID=
The channel is optional. .env is ignored by Git and loaded automatically.
Stop any previous instance, then run:
.venv/bin/python examples/sponge.py --sync
Try /hello, /wisdom, /duck, /feed, /motto, /duck_motto, /poll,
/remind, /reminders, or /cancel_reminder. motto requires Manage Server.
Use --sync after changing command definitions; omit it for ordinary restarts.
The original minimal example remains available:
.venv/bin/python examples/bot.py --sync
.venv/bin/python examples/bot.py --preview hello
First-time Discord setup explains the bot token, installation,
permissions, server and channel IDs. Neither example requires an interactions URL.
Slash commands need no privileged intents. Calling bot.welcome() opts into
Server Members Intent, which must also be enabled in Discord's Developer Portal.
Install from a fresh checkout
uv venv --python 3.15 .venv
uv pip install -e .
For contributors running all backend tests, install the locked dependencies too:
uv pip install -r requirements.lock
uv pip install --no-deps -e .
.venv/bin/python -m pytest -q
The core library does not require FastAPI, PostgreSQL or the web frontend. Those
are separate optional dependencies. requirements.lock pins the tested full
contributor/backend environment; the published package uses compatible ranges.
Learn the API
- Authoring guide: command functions, response types, permissions, storage, polls, reminders and schedules.
- Sponge's source: a complete consumer of the public package API.
- AI coding reference: canonical patterns, API links and boundaries.
- v2 implementation plan and implementation status: the web editor and hosted services remain paused.
Portable definitions
Static text/Embed replies can be exported with bot.to_definition() for the shared
preview/Discord engine. Python callbacks and interactive/background features stay
in Python source; export rejects these instead of silently discarding them.
.venv/bin/discord-bot-maker template greeting > bot.json
.venv/bin/discord-bot-maker validate bot.json
.venv/bin/discord-bot-maker preview bot.json --command hello
.venv/bin/discord-bot-maker run bot.json --sync --guild-id YOUR_SERVER_ID
Existing users
The distribution is discord-bot-maker; Python imports stay discord_bot_maker.
DBot, createCommand(), bRun(), and the original prefix API remain available.
For new bots use Bot.from_env(), reply() and @bot.command().
The unfinished v1 Command builder is now an immutable command definition.
User-facing replies have no forced attribution or author mentions.
MIT licensed. Created by Aaryan Dehade.
PyPI release
After 2.0.0a1 has been published, install the prerelease with:
python -m pip install --upgrade 'discord-bot-maker==2.0.0a1'
See the release guide, changelog, and v1 migration guide. Only the Python package is being prepared for PyPI; the web app is a separate work in progress.
Metadata
Release files for discord-bot-maker 2.0.0a1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| discord_bot_maker-2.0.0a1.tar.gz | 70.8 kB | Without provenance | Details for discord_bot_maker-2.0.0a1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| discord_bot_maker-2.0.0a1-py3-none-any.whl | Python 3 | none | any | Details for discord_bot_maker-2.0.0a1-py3-none-any.whl |
Total release size: 106.4 kB
Release files / discord_bot_maker-2.0.0a1.tar.gz
| Download URL | discord_bot_maker-2.0.0a1.tar.gz |
|---|---|
| Size | 70.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
95385ce96e40a8146b318ea2125d2e769a659e8b02da6c5cdc30aa4c4b86bde4
|
|
BLAKE2b-256 checksum How to use checksums |
77d4df399ed0f515cd6573d74acfae68cc64ec70db95f018fb147676fb541b56
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.15.0
|
Release files / discord_bot_maker-2.0.0a1-py3-none-any.whl
| Download URL | discord_bot_maker-2.0.0a1-py3-none-any.whl |
|---|---|
| Size | 35.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ded028cb60dffcc108f2849a543af45512063cd7553c5a12f2ac984f2e0f61a8
|
|
BLAKE2b-256 checksum How to use checksums |
aadce4beb9fa8e11cac6ec2032a33c4a6da30e258dc04181f5e8ae28274ccd7e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.15.0
|
Security for discord-bot-maker 2.0.0a1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.