A Python library for Discord bots using HTTP interactions, with optional WebSocket support and full cache control.
- Lightweight and fully customisable, no bloat or forced abstractions
- HTTP-first with optional WebSocket support when you need it
- Full cache control, you decide what gets stored and what does not
- Barebone and developer-first, designed to get out of your way
- Supports both guild install and user install bot types
The API is designed to feel familiar if you are coming from discord.py, so switching between the two should not require much relearning.
Requirements & Installing
- Python 3.11 or newer
- A web server to receive HTTP requests from Discord (nginx, Apache, etc.)
Install by using pip install discord.http in the terminal.
If pip does not work, there are other ways to install as well, most commonly:
python -m pip install discord.httppython3 -m pip install discord.httppip3 install discord.http
[!NOTE] Want to test the latest changes before the next release? Install the beta with
git+https://github.com/AlexFlipnote/discord.http@masterinstead ofdiscord.http. It can be unstable and unreliable, so use it at your own risk.
Quick example
from discord_http import Context, Client
client = Client(
token="Your bot token here"
)
@client.command()
async def ping(ctx: Context):
""" A simple ping command """
return ctx.response.send_message("Pong!")
client.start()
Want to also listen to gateway events? Pass enable_gateway=True to the client along with your desired intents.
Need further help on how to make Discord API able to send requests to your bot? Check out the documentation for more detailed information.
Running tests
Automated tests use Python's built-in unittest module.
Run all tests from the project root:
make test- or
python -m unittest discover -s tests -p "test_*.py"
Resources
1 maintainer
Metadata
1 maintainer
Release files for discord.http 3.1.6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| discord_http-3.1.6.tar.gz | 194.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| discord_http-3.1.6-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 403.1 kB
Release files / discord_http-3.1.6.tar.gz
| Download URL | discord_http-3.1.6.tar.gz |
|---|---|
| Size | 194.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6b62e72aac3cbdd2f490f2128c910a873e4c680c574ce20301cfb6d031bda3e3
|
|
BLAKE2b-256 checksum How to use checksums |
15b6c50e7480a3dacfb19118abec2d928f244a2394cb9d4f1f8774eafddd5eb9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.9 {"installer":{"name":"uv","version":"0.9.9"},"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}
|
Release files / discord_http-3.1.6-py3-none-any.whl
| Download URL | discord_http-3.1.6-py3-none-any.whl |
|---|---|
| Size | 208.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
94d01d1f695afea78d2b8c16ce5e227166bd298caee16d5af05d7d5e1c7b4967
|
|
BLAKE2b-256 checksum How to use checksums |
73c3088c7be92b5dbaf4fcfcc5d13ddfdec272df7761d6d006513aa279a6db11
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.9 {"installer":{"name":"uv","version":"0.9.9"},"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}
|
