revoltcord.py is an open‑source Python library designed to make Discord.py‑style bots run on the Revolt chat platform with little to no code changes.
Its goal is to provide a compatibility layer that mirrors the Discord.py API while translating all operations into Revolt’s REST and WebSocket systems.
This project aims to make it easy for developers to migrate their existing Discord bots to a fully self‑hosted, privacy‑respecting Revolt server.
- Discord.py‑style API compatibility
- Command framework (
@bot.command()) - Event system (
on_message,on_ready, etc.) - REST API wrapper for Revolt
- WebSocket gateway listener
- Models for messages, users, channels, servers
- Minimal or zero code changes for Discord.py bots
- Full documentation and examples
Once the library reaches alpha stage, it will be installable via:
pip install revoltcord.py
For now, clone the repository:
git clone https://github.com/yourusername/revoltcord.py
from revoltcord import commands
bot = commands.Bot(command_prefix="!")
@bot.command()
async def ping(ctx):
await ctx.send("Pong!")
bot.run("YOUR_REVOLT_BOT_TOKEN")Contributions are welcome! Please read the Contribution file for guidelines on how to get started.
Full documentation will be available in the docs/ directory and will be published online once the project reaches a stable state.
This project is licensed under the MIT License. See the LICENSE.md file for details.
Inspired by the original discord.py project
Built for the Revolt open‑source ecosystem
Community contributions are highly appreciated