Welcome to ScurryPy¶
ScurryPy is a lightweight, modern Discord API framework powering everything from tiny utility bots to full custom frameworks. And, of course, a healthy amount of squirrel-related chaos.
Features¶
ScurryPy is designed to be small, predictable, and transparent:
- Lightweight core (<1000 lines)
- Proper rate limit handling
- Automatic session + gateway reconnection
- Automatic sharding
- Stable, typed event models
- Clean resource classes for API calls
Why ScurryPy?¶
ScurryPy is built on a single philosophy: ✨clarity over magic ✨
- Every operation is explicit
- No black boxes or hidden behavior
- No side effects
- Components do one job, and do it predictably
ScurryPy is not another discord.py clone; it’s a fresh implementation built to be fully transparent and easy to reason about.
Extending ScurryPy¶
ScurryPy is intentionally minimal. You can build helpers, routers, command systems, and even entire frameworks on top of it.
However, certain core systems cannot be modified:
- Gateway behavior
- REST internals
- Discord-enforced specifications
- Event model definitions
These remain stable to ensure compliance with the Discord API.
For higher-level features such as decorators, routing, and stateful commands, consider ScurryKit — a framework built on top of ScurryPy.