Skip to main content

A python wrapper for the Discord API

Project description


[![PyPI](]( is an API wrapper for Discord written in Python.

This was written to allow easier writing of bots or chat logs.

## Installing

Installing is pretty easy.

pip install

Will install the latest 'stable' version of the library.

If you want to install the development version of the library, then do the following:

pip install git+

Note that this requires `git` to be installed.

### This module is alpha!

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

I recommend that you follow the discussion in the [unofficial Discord API discord channel][ch] and update your installation periodically through `pip install --upgrade`.


## Quick Example

import discord

client = discord.Client()
client.login('email', 'password')

def on_message(message):
if message.content.startswith('!hello'):
client.send_message(, 'Hello was received!')

def on_ready():
print('Logged in as')

You can find examples in the examples directory.

## Requirements

- Python 2.7+ or Python 3.3+.
- `ws4py` library
- `requests` library

Usually `pip` will handle these for you.

## Related Projects

- [discord.js](
- [](
- [Discord.NET](
- [DiscordSharp](
- [Discord4J](
- [discordrb](

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for, version 0.9.1
Filename, size File type Python version Upload date Hashes
Filename, size (27.9 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page