🔧 Fork Notice

This fork is made with naoTimes in mind.

This fork will focus on improving and adding feature for the library.

What this fork does:

• Adding new feature like slash command, user command, and message command.
• Adding new feature that are in Discord canary or beta (as long as it's being documented in the API).
• PEP8 friendly, you can check the flake8 and black configuration for more info.

What this fork does not do:

• Removing feature or doing radical changes to the project structure.

This fork is maintained solely by N4O#8868. If you want to help, please contact me at Discord. You can also open a new PR or Issue if you want.

ndiscord.py

A modern, easy to use, feature-rich, and async ready API wrapper for Discord written in Python.

The Future of discord.py

Rapptz has discontinued working on discord.py with reason you can read at this gist. This fork will not be "the new discord.py" but more like a discord.py that will be used for my own personal bot.

Key Features

• Modern Pythonic API using async and await.
• Proper rate limit handling.
• Optimised in both speed and memory.
• Slash command, user context command, and message context command support.

Installing

Python 3.8 or higher is required

You can only install this library by using development version:

$ pip install -U git+https://github.com/naoTimesdev/ndiscord.py

or clone it manually:

$ git clone https://github.com/naoTimesdev/ndiscord.py
$ cd discord.py
$ python3 -m pip install -U .[voice]

Optional Packages

• PyNaCl (for voice support)

Please note that on Linux installing voice you must install the following packages via your favourite package manager (e.g. apt, dnf, etc) before running the above commands:

• libffi-dev (or libffi-devel on some systems)
• python-dev (e.g. python3.6-dev for Python 3.6)

Quick Example

import discord

class MyClient(discord.Client):
    async def on_ready(self):
        print('Logged on as', self.user)

    async def on_message(self, message):
        # don't respond to ourselves
        if message.author == self.user:
            return

        if message.content == 'ping':
            await message.channel.send('pong')

client = MyClient()
client.run('token')

Bot Example

import discord
from discord.ext import commands

bot = commands.Bot(command_prefix='>')

@bot.command()
async def ping(ctx):
    await ctx.send('pong')

bot.run('token')

You can find more examples in the examples directory.

Slash Command Example

import discord
from discord.ext import app, commands

bot = commands.Bot(command_prefix='n!')

@bot.command()
async def ping(ctx):
    await ctx.send('pong')

@app.slash_command()
@app.option('content', str)
async def echo(ctx, content):
    await ctx.send(content)

bot.run('token')

Links

• Documentation
• Discord API Server