skip to navigation
skip to content

disco-py 0.0.11rc7

A Python library for Discord

Latest Version: 0.0.11rc8

# disco
Disco is a simple and extendable library for the [Discord API]( Join the Official channel and chat [here](

- Expressive, functional interface that gets out of the way
- Built for high-performance and efficiency
- Configurable and modular, take the bits you need
- Full support for Python 2.x/3.x
- Evented networking and IO using Gevent


Disco is currently in an early-alpha phase. What you see today may change a lot tomorrow. If you are looking to build a serious bot with this, wait for a stable release.

## Installation

Disco was built to run both as a generic-use library, and a standalone bot toolkit. Installing disco is as easy as running `pip install disco-py`, however some extra packages are recommended for power-users, namely:

|requests[security]|adds packages for a proper SSL implementation|
|ujson|faster json parser, improves performance|
|erlpack|ETF parser, only Python 2.x, run with the --encoder=etf flag|
|gipc|Gevent IPC, required for autosharding|

## Examples

Simple bot using the builtin bot authoring tools:

from import Bot, Plugin

class SimplePlugin(Plugin):
# Plugins provide an easy interface for listening to Discord events
def on_channel_create(self, event):'Woah, a new channel huh!')

# They also provide an easy-to-use command component
def on_ping_command(self, event):

# Which includes command argument parsing
@Plugin.command('echo', '<content:str...>')
def on_echo_command(self, event, content):

Using the default bot configuration, we can now run this script like so:

`python -m disco.cli --token="MY_DISCORD_TOKEN" --run-bot --plugin simpleplugin`

And commands can be triggered by mentioning the bot (configured by the BotConfig.command\_require\_mention flag):

File Type Py Version Uploaded on Size
disco-py-0.0.11rc7.tar.gz (md5) Source 2017-07-17 66KB