pyvolt

A simple, flexible API wrapper for Revolt.

Note

This is beta software. Please report bugs on GitHub issues if you will find any.

Key Features

• Built on asyncio.
• Sane rate limit handling that prevents 429s
• Fast. Really faster than Revolt.py and voltage.
• Low memory usage.
• Customizable architecture. Build object parser in Rust to achieve high speeds.
• Focuses on supporting both, bot and user accounts.

Installing

Python 3.10 or higher is required

To install the library, you can just run the following command:

# Linux/macOS
python3 -m pip install -U git+https://github.com/MCausc78/pyvolt@master

# Windows
py -3 -m pip install -U git+https://github.com/MCausc78/pyvolt@master

Quick Example

from pyvolt import Client

class MyClient(Client):
    async def on_ready(self, _, /):
        print('Logged on as', self.me)

    async def on_message(self, message, /):
        # don't respond to ourselves
        if message.author_id == self.me.id:
            return

        if message.content == 'ping':
            await message.channel.send('pong')

# You can pass `bot=False` to run as user account
client = MyClient(token='token')
client.run()

Bot Example

from pyvolt.ext import commands

# Pass `self_bot=True` to make your bot listen only to you
bot = commands.Bot(command_prefix='!')

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

token = 'token'

# That's also allowed, just like in `discord.py`. Pass `bot=False` keyword argument if you want to run as user account.
bot.run(token)

Links

• Documentation
• Official Revolt Server
• Revolt API

Why Not

• pyrevolt - Doesn't follow PEP8 and does a ton of requests on startup (not member list).
• voltage - Slow and simply copypasta from revolt.py.
• revolt.py - Slow and unable to disable member list loading.
• luster - Unmaintained library.