Skip to content

SoSad

Drop in. Scale up.

A modern, modular, type-safe Discord framework built on Hikari.

Change one line. Get production-ready features instantly.

import sosad.compat as discord  # ← that's it

bot = discord.Bot(intents=discord.Intents.default())

@bot.command(name="ping")
async def ping(ctx):
    await ctx.send("Pong!")

bot.run("TOKEN")

Get Started View on GitHub

Why SoSad?

For hobby bots → production

Feature discord.py SoSad
Rate limiting Manual Automatic
Error handling try/except Pipeline
DI None FastAPI-style
Middleware Before/After ASGI pipeline
Plugins Manual Auto-discover
Config .env manual class Config(sosad.Settings)
Type safety Partial Full strict

For new projects

import hikari
import sosad

class Config(sosad.Settings):
    token: str

bot = sosad.Client(token=Config().token, intents=hikari.Intents.ALL_UNPRIVILEGED)

@sosad.slash_command("ping", "Pong!")
async def ping(ctx: sosad.InteractionContext):
    await ctx.respond("Pong!")

bot.run()

Quick install

pip install sosad
# or
uv add sosad

Features