commanderbot-py
A collection of utilities and extensions for discord.py bots.
Requirements
- Python 3.14+
- discord.py 2.7+
Running your bot
You can run your own bot without writing any code.
You will need the following:
- Your own Discord Application with a bot token.
- A configuration file for the bot.
- A Python 3.14+ environment.
- It is recommended to use a virtual environment for this.
- You can use pyenv to build and run Python 3.14.
- Run
pip install commanderbotto install the bot core package.
The first thing you should do is check the CLI help menu:
python -m commanderbot --help
There are several ways to provide a bot token:
- (Recommended) As the
BOT_TOKENenvironment variable:BOT_TOKEN=put_your_bot_token_here- Supports
.envfiles: use.envin the working directory or provide the--envfileoption
- Supports
- As a CLI option:
--token put_your_bot_token_here - As a standalone file:
--tokenfile path_to_file_with_bot_token - Manually, when prompted during start-up
Here's an example that provides the bot token as an argument:
python -m commanderbot bot.json --token put_your_bot_token_here
Configuring your bot
The current set of configuration options is limited. The following is an example configuration that sets the command prefix, enabled privileged intents, and loads the sudo, status and faq extensions.
The
sudoextension is essential to managing the bot. It can do things like syncing commands, setting the bot's profile picture, or even exporting the config.
An extension prefixed with
$means the extension is required and cannot be managed while the bot is running. If the extension's config uses the object syntax, you can make the extension required by adding"required": true.
Note that with this configuration, the
faqextension will require read-write access tofaq.jsonin the working directory.
{
"command_prefix": ".",
"privileged_intents": {
"message_content": true,
"members": true
},
"extensions": [
"$commanderbot.ext.sudo",
"commanderbot.ext.status",
{
"name": "commanderbot.ext.faq",
"options": {
"database": "faq.json"
}
}
]
}
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file commanderbot-0.23.0.tar.gz.
File metadata
- Download URL: commanderbot-0.23.0.tar.gz
- Upload date:
- Size: 185.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.12.6 {"installer":{"name":"uv","version":"0.12.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d596550871722236ee5990fe4f8574ca38a688a0b79891b9a27d667ebc236948
|
|
| MD5 |
a4f92f68eccbeea577962ed7d689e059
|
|
| BLAKE2b-256 |
86447161920b2049372227604e6c6bba01ceff49899cee32bd52402ff101ac8c
|
File details
Details for the file commanderbot-0.23.0-py3-none-any.whl.
File metadata
- Download URL: commanderbot-0.23.0-py3-none-any.whl
- Upload date:
- Size: 340.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.12.6 {"installer":{"name":"uv","version":"0.12.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e8a6db4a8ad3ffae3a8b9a7a0c6817ebff753eced0a820efed3db2d266380224
|
|
| MD5 |
bc9f4ebe73118f5345729ad94166c01c
|
|
| BLAKE2b-256 |
2349c217f33094179e959b0867d50325abe99dd398c90725a7bbae2ff0d12b88
|
