An API wrapper for Discord written in Python.
Branch: rewrite
Clone or download
Pull request Compare This branch is 111 commits ahead of Rapptz:rewrite.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore gitignore: ignore egg-info and venvs Aug 23, 2018
LICENSE Bumped copyright years to 2019. Jan 29, 2019 Fix README.rst for PyPi Jan 29, 2019
requirements.txt ~~ Feb 13, 2019


NOTE: This is a fork of that is kept automatically up-to-date with the upstream/rewrite branch of There are slight modifications which do not change any major core compatibility. Several GieselaDev repos and others pull from here. Targeted for Python >=3.6+ using rewrite with voice.

Python Versions Maintained License

Info is an API wrapper for Discord written in Python.

This was written to allow easier writing of bots or chat logs. Make sure to familiarise yourself with the API using the documentation.

Breaking Changes

The discord API is constantly changing and the wrapper API is as well. There will be no effort to keep backwards compatibility in versions before v1.0.0.

I recommend joining either the official server or the Discord API server for help and discussion about the library.


To install the development version, do the following:

python3 -m pip install -U[voice]

or the more long winded from cloned source:

$ git clone --branch rewrite
$ cd
$ python3 -m pip install -U .[voice]

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

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

Quick Example

import discord
import asyncio

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

    async def on_message(self, message):
        # don't respond to ourselves
        if == self.user:
        if message.content.startswith('!test'):
            counter = 0
            tmp = await'Calculating messages...')
            async for msg in
                if ==
                    counter += 1

            await tmp.edit(content='You have {} messages.'.format(counter))
        elif message.content.startswith('!sleep'):
                await asyncio.sleep(5.0)
                await'Done sleeping.')

client = MyClient()'token')

You can find examples in the examples directory.


  • Python 3.6.3+
  • aiohttp library
  • websockets library
  • PyNaCl library (optional, for voice only)
    • On Linux systems this requires the libffi library. You can install in debian based systems by doing sudo apt-get install libffi-dev.

Usually pip will handle these for you.