ThomasJRyan / guilded.py

Asynchronous Guilded API wrapper for Python

Welcome to guilded.py, a discord.py-esque asynchronous Python wrapper for Guilded's user and bot APIs. If you know discord.py, you know guilded.py.

Documentation

In the works. Fortunately, if you've used discord.py before, you'll already have a head start.

Basic Example

import guilded

client = guilded.Client(user_id='bot_user_id')
# If you're using a userbot, you would use UserbotClient() instead.

@client.event
async def on_ready():
    print('Ready')

@client.event
async def on_message(message):
    if message.author == client.user:
        return
    if message.content == 'ping':
        await message.channel.send('pong!')

client.run('token')
# If you're using a userbot, you would use an email & password instead of an access token.

Bot example

import guilded
from guilded.ext import commands

bot = commands.Bot(user_id='bot_user_id', command_prefix='!')
# If you're using a userbot, you would use UserbotBot() instead.

@bot.command()
async def ping(ctx):
    await ctx.send('pong!')

bot.run('token')
# If you're using a userbot, you would use an email & password instead of an access token.

For more examples, see the examples directory in this repository.

Support

Guilded.py has a support channel under its dedicated group for any questions you may have.

1. Join the Guilded-API server
2. Navigate to #library-list
3. Click on the guilded.py role and click "Add me to role"
4. You should see a new group pop up in your sidebar - you are now in the Guilded.py group