disnake
A modern, easy to use, feature-rich, and async-ready API wrapper for Discord written in Python.
Key Features
- Proper rate limit handling.
- Type-safety measures.
- FastAPI-like slash command syntax.
The syntax and structure of discord.py 2.0 is preserved.
Installing
Python 3.10 or higher is required.
To install the library without full voice support, you can just run the following command:
# Linux/macOS
python3 -m pip install -U disnake
# Windows
py -3 -m pip install -U disnake
Installing disnake with full voice support requires you to replace disnake here, with disnake[voice]. To learn more about voice support (or installing the development version), please visit this section of our guide.
Note that voice support on Linux requires installation of libffi-dev and python-dev packages, via your preferred package manager (e.g. apt, dnf, etc.) before running the following commands.
Versioning
This project does not quite follow semantic versioning; for more details, see version guarantees.
To be on the safe side and avoid unexpected breaking changes, pin the dependency to a minor version (e.g. disnake==a.b.* or disnake~=a.b.c) or an exact version (e.g. disnake==a.b.c).
Quick Example
Slash Commands Example
import disnake
from disnake.ext import commands
bot = commands.InteractionBot(test_guilds=[12345])
@bot.slash_command()
async def ping(inter):
await inter.response.send_message("Pong!")
bot.run("BOT_TOKEN")
Context Menus Example
import disnake
from disnake.ext import commands
bot = commands.InteractionBot(test_guilds=[12345])
@bot.user_command()
async def avatar(inter, user):
embed = disnake.Embed(title=str(user))
embed.set_image(url=user.display_avatar.url)
await inter.response.send_message(embed=embed)
bot.run("BOT_TOKEN")
Prefix Commands Example
import disnake
from disnake.ext import commands
bot = commands.Bot(command_prefix=commands.when_mentioned)
@bot.command()
async def ping(ctx):
await ctx.send("Pong!")
bot.run("BOT_TOKEN")
You can find more examples in the examples directory.
Documentation ⁕ Guide ⁕ Discord Server ⁕ Discord Developers
Release files for disnake 2.12.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 | |
|---|---|---|---|
| disnake-2.12.1.tar.gz | 1.1 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| disnake-2.12.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 2.3 MB
Release files / disnake-2.12.1.tar.gz
| Download URL | disnake-2.12.1.tar.gz |
|---|---|
| Size | 1.1 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b7d8732484277af084d2082fdbf9595a7a193f8f381639005f281a98ec5386d2
|
|
BLAKE2b-256 checksum How to use checksums |
b14f052738b078cea59fe768bfd7b719e0530a8d21abaf118d993ec9734bca45
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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 Jul 22, 2026.
Transparency logRelease files / disnake-2.12.1-py3-none-any.whl
| Download URL | disnake-2.12.1-py3-none-any.whl |
|---|---|
| Size | 1.2 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
52e5e17e107c015dd951fbcab3020943ea1e8b5dcc7bd384fb476818dc014d61
|
|
BLAKE2b-256 checksum How to use checksums |
2ffaa9e2f0fc0a022048d1d9a0877bfa8859400de77564c0d4bbc650a6638921
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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 Jul 22, 2026.
Transparency log
