Welcome to discord.py

discord.py is a modern, easy to use, feature-rich, and async ready API wrapper for Discord.

Features:

• Modern Pythonic API using async/await syntax

• Sane rate limit handling that prevents 429s

• Implements the entire Discord API

• Command extension to aid with bot creation

• Easy to use with an object oriented design

• Optimised for both speed and memory

Documentation Contents

• Introduction
  • Prerequisites
  • Installing
  • Basic Concepts
• Quickstart
  • A Minimal Bot
• Migrating to v1.0
  • Python Version Change
  • Major Model Changes
  • Sending Messages
  • Asynchronous Iterators
  • Event Changes
  • Voice Changes
  • Waiting For Events
  • Upgraded Dependencies
  • Sharding
  • Connection Improvements
  • Command Extension Changes
• Setting Up Logging
• API Reference
  • Version Related Info
  • Client
  • Voice
  • Event Reference
  • Utility Functions
  • Profile
  • Enumerations
  • Async Iterator
  • Audit Log Data
  • Webhook Support
  • Abstract Base Classes
  • Discord Models
  • Data Classes
  • Exceptions

Extensions

• discord.ext.commands – Bot commands framework
  • Commands
    • Parameters
    • Invocation Context
    • Converters
    • Error Handling
    • Checks
  • Cogs
    • Quick Example
    • Cog Registration
    • Using Cogs
    • Special Methods
    • Meta Options
    • Inspection
  • Extensions
    • Primer
    • Reloading
    • Cleaning Up
  • API Reference
    • Bot
    • Event Reference
    • Command
    • Cogs
    • Help Commands
    • Checks
    • Context
    • Converters
    • Exceptions
• discord.ext.tasks – asyncio.Task helpers
  • Recipes
  • API Reference

Additional Information

• Creating a Bot Account
  • Inviting Your Bot
• Frequently Asked Questions
  • Coroutines
  • General
  • Commands Extension
• Changelog
  • v1.0.1
  • v1.0.0
  • v0.16.6
  • v0.16.1
  • v0.16.0
  • v0.15.1
  • v0.15.0
  • v0.14.3
  • v0.14.2
  • v0.14.1
  • v0.14.0
  • v0.13.0
  • v0.12.0
  • v0.11.0
  • v0.10.0
• Version Guarantees
  • Examples of Breaking Changes
  • Examples of Non-Breaking Changes

If you still can’t find what you’re looking for, try in one of the following pages:

• Index

• Module Index

• Search Page