← back to docs
Quick start API reference Plugins

Bot Builder

Pick what you want, get a working bot.py. Fill in the channel IDs and you're good to go.

Bot settings

Auto-restart on crash
Restarts if something breaks
Auto-restart on file save
Reloads when you save bot.py
JSON logs
Structured log output
Health endpoint
GET /health on port 8080
Persistent storage
Saves data between restarts (JsonStore)
Global error handler
Catch errors so users see a message

Commands

Event listeners

on_ready
Runs when the bot connects
message:created
Runs on every new message
server:member_joined
Runs when someone joins
server:member_left
Runs when someone leaves
message:reaction_added
Runs when someone reacts
channel:typing
Runs when someone starts typing

Scheduled tasks pip install croniter

Contrib plugins pip install nerimity-sdk-contrib

WelcomePlugin
Greet new members
LoggingPlugin
Log joins, leaves, edits, deletes
AutoModPlugin
Delete messages with blocked words
AntiSpamPlugin
Kick/ban users who spam
LevelingPlugin
XP system, /level, /leaderboard
WarnPlugin
/warn, /warnings, /clearwarns
MutePlugin
/mute and /unmute users
StarboardPlugin
Repost popular messages
BirthdayPlugin
/birthday, daily announcements
ReminderPlugin
/remind 10m do something
AFKPlugin
/afk, pings back when mentioned
CustomCommandPlugin
Admins add text commands at runtime
AutoReplyPlugin
Keyword-triggered auto-replies
ServerStatsPlugin
Post periodic stats to a channel
TempChannelPlugin
Auto-deleting temporary channels
PollPlugin
Timed reaction polls
GiveawayPlugin
React-to-enter giveaways
TicketPlugin
DM-based support tickets

Deploy target

Choose where you want to host your bot. We'll add the right config file.

🚂
Railway
Free tier, easy setup
🪰
Fly.io
Global edge hosting
🎨
Render
Git-connected deploys
🖥️
VPS / Linux
systemd service file
🐳
Docker
Dockerfile + compose
⏭️
Skip
No deploy config

Generated bot.py


      
    

    

      
      
      Setup guide →