Home

{Introduction}

---

This is the documentation for discord.py, a library for Python to aid in creating applications that utilize the Discord API.

---

{Prerequisites}

discord.py works with Python 3.5.3 or higher. Support for earlier versions of Python is not provided. Python 2.7 or lower is not supported. Python 3.4 or lower is not supported due to one of the dependencies (aiohttp) not supporting Python 3.4.

---

{Installing}

You can get the library directly from PyPI:

py -3 -m pip install -U discord.py

To get voice support, you should use discord.py[voice] instead of discord.py, e.g.

python3 -m pip install -U discord.py[voice]

---

Basic Concepts

---

discord.py revolves around the concept of events. An event is something you listen to and then respond to. For example, when a message happens, you will receive an event about it that you can respond to.

A quick example to showcase how events work:

import discord

class MyClient(discord.Client):
    async def on_ready(self):
        print('Logged on as {0}!'.format(self.user))

    async def on_message(self, message):
        print('Message from {0.author}: {0.content}'.format(message))

client = MyClient()
client.run('my token goes here')

visit discord.py docs for more info!