YourBot SDK
SDK for building plugins for the YourBot Discord bot platform.
YourBot runs marketplace plugins in sandboxed Docker containers. This SDK is the official Python interface plugins use to receive Discord events, call the Discord API, store data, render dashboards, and emit metrics — all routed through the platform so plugins never need direct network access or credentials.
Install
pip install yourbot-sdk
Python 3.10 or newer.
Hello, plugin
from yourbot_sdk import Plugin, Context
plugin = Plugin()
@plugin.on_event("message_create")
def on_message(ctx: Context, event: dict):
if "!ping" in event.get("content", ""):
ctx.discord.send_message(
channel_id=event["channel_id"],
content="Pong!",
)
plugin.run() # must be the last line
Drop this in a folder named my_plugin/ as __main__.py, zip it, and upload it
via the Developer Portal.
CLI
The package installs a yourbot command for scaffolding and a local dev loop:
yourbot new my_plugin # scaffold a new plugin from the template
yourbot dev # run your plugin locally against a mock host
Documentation
Full plugin contract, capability reference, and publishing guide:
- Docs: https://yourbot.gg/docs/developers
- Developer Portal: https://yourbot.gg/dev (sign-in required)
License
MIT — see LICENSE.
1 maintainer
Release files for yourbot-sdk 0.10.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| yourbot_sdk-0.10.1.tar.gz | 104.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| yourbot_sdk-0.10.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 211.9 kB
Release files / yourbot_sdk-0.10.1.tar.gz
| Download URL | yourbot_sdk-0.10.1.tar.gz |
|---|---|
| Size | 104.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
977a0e9fff4f2e70577c7312291dbd0c370025d16080526dfb55505eca416964
|
|
BLAKE2b-256 checksum How to use checksums |
dbcf83b1be6152f82ee8bbc4f8159b0d052b3c5603d8079d7855b529d60c9152
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 11, 2026.
Transparency logRelease files / yourbot_sdk-0.10.1-py3-none-any.whl
| Download URL | yourbot_sdk-0.10.1-py3-none-any.whl |
|---|---|
| Size | 107.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
18cb89ca6956c54b4c3ddae124b8d32e094c17dabaafd22bd5ebffb9704de710
|
|
BLAKE2b-256 checksum How to use checksums |
d99ec03ff9412f1d6e8ddf3dcf4eb2ba2bec265b6d37630c0afe10d7128b21c6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 11, 2026.
Transparency log
