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.

Installing

Python 3.10 or higher is required.

To install the library without full voice support, you can just run the following command:

sh
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

py
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

py
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.setimage(url=user.displayavatar.url)     await inter.response.send_message(embed=embed)
bot.run("BOT_TOKEN")

Prefix Commands Example

py
import disnake
from disnake.ext import commands
bot = commands.Bot(commandprefix=commands.whenmentioned)
@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