by Pycord-Development



Discord server invite PyPI version info PyPI supported Python versions

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

Key Features

  • Modern Pythonic API using async and await.
  • Proper rate limit handling.
  • Optimised in both speed and memory.
  • Supports Slash Commands, Context Menus and Message Components.


Python 3.8 or higher is required

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

# Linux/macOS
python3 -m pip install -U py-cord

# Windows
py -3 -m pip install -U py-cord

Otherwise to get voice support you should run the following command:

# Linux/macOS
python3 -m pip install -U "py-cord[voice]"

# Windows
py -3 -m pip install -U py-cord[voice]

To install the development version, do the following:

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

Optional Packages

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

bot = discord.Bot()

async def hello(ctx, name: str = None):
    name = name or
    await ctx.respond(f"Hello {name}!")

@bot.user_command(name="Say Hello")
async def hi(ctx, user):
    await ctx.respond(f"{} says hello to {}!")"token")

Normal Commands Example

import discord
from discord.ext import commands

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

async def ping(ctx):
    await ctx.send("pong")"token")

You can find more examples in the examples directory.