NanoBot docs Moderation for your phone

Discord bot docs

Moderate from your phone

NanoBot is a lightweight Discord moderation bot designed around fast, thumb-friendly workflows — slash commands, prefix commands, and mention support all in one.

Why mobile-first

  • Big tap targets. Short, focused sections.
  • Commands target the last sender — no typing user IDs.
  • Slash, prefix, and @mention support across every command.
  • Role panels and reminders survive bot restarts.
⚡No dashboard 🔒SQLite local 🐳Docker ready

By the numbers

What's inside NanoBot

368 command definitions covering moderation, utility, community, social, fun, and music — with permission gating baked in from the start.

368

Total commands

Slash, prefix, and @mention variants.

189

Public commands

No elevated Discord permissions needed.

159

Restricted commands

Permission-gated for server staff.

20

Owner admin commands

Reload cogs, update, sync, and manage config without restarting.

26

Social actions

Quick reaction-style prefix shortcuts.

33

Fun one-liners

Single-word commands for fast server banter.

Jump right in

Find what you need

New? Start with Setup. Running your own instance? Self-Hosting covers Docker, config keys, logs, and owner maintenance.

Commands

Full command reference with search and category filters. Grouped by workflow, not by source file.

Setup

Six steps from a fresh clone to a running bot. No extra tooling required.

Self-Hosting

Config reference, Docker path, log location, data directories, and every owner maintenance command.

FAQ

Quick answers to common questions about intents, persistence, Groq setup, and Docker.

Privacy

What NanoBot stores, what it never stores, third-party calls, and how to request deletion.

Mobile-first design choices

Built around how you actually moderate

  • Most moderation commands target the last message sender when no user is specified — no copying IDs on a phone keyboard.
  • Role panels are button-driven in Discord and persist across bot restarts.
  • Tags work as both n!tag hello and shorthand n!hello.
  • Reminders, timed bans, and recurring events all restore on boot.

Quick requirements

What you need to run NanoBot

  • Python 3.11 or newer.
  • A Discord bot token with Server Members and Message Content intents enabled.
  • Dependencies from requirements.txt.
  • Optional: Groq API key for /eli5 and WYR generation.

Add NanoBot to Discord

Invite NanoBot to your server

Use the official invite link to add NanoBot with slash commands and moderation permissions preconfigured.

Invite NanoBot