scurrypy 1.0.0

Dataclass-driven Discord API Wrapper in Python

ScurryPy

✨ Clarity over magic: a sandbox for Discord's API where you control everything ✨

ScurryPy is a fully extensible foundation for building bots, frameworks, and tools. You design the architecture.

Features

The following are baked into ScurryPy:

• Lightweight core
• Rate limit handling
• Automatic session & gateway management
• Automatic sharding
• Predictable event models and resource classes

Your focus is building what you want.

See the manifesto section for details!

Who ScurryPy is for

ScurryPy is for developers who want full control of Discord API usage, design their own frameworks, or learn how bots work under the hood. If you want ready-made commands, consider using ScurryKit or another framework.

Installation

Install ScurryPy with pip:

pip install scurrypy

Quick Start

# --- Core library imports ---
from scurrypy import Client, ReadyEvent

# --- Setup bot ---
client = Client(token=TOKEN)

async def on_ready(event: ReadyEvent):
    print("Bot is online!")

client.add_event_listener("READY", on_ready)

# --- Run the bot ---
client.run()

What You Can Build

ScurryPy's clean architecture supports:

• Custom command frameworks
• Multi-bot orchestration systems
• Discord API explorers and tools
• Bots with complex state management
• Your own discord.py alternative

Check out ScurryKit - a batteries-included framework built entirely on ScurryPy.

Dependencies

ScurryPy has exactly 3 required dependencies:

• aiohttp (HTTP client)
• websockets (Gateway connection)
• aiofiles (Async file operations)

That's it. No bloat, no surprises, no supply-chain concerns. These dependencies are automatically installed with ScurryPy's pip package.

Like What You See?

Explore the full documentation for more examples, guides, and API reference.

Switching from discord.py? Check out the Migration Guide to see the difference.

Got some questions? Check out the FAQ page for commonly asked questions!

Looking for changes? See the Changelog.