// getting started

Quick setup

This page walks you from zero to a fully configured kesarAI in about five minutes. By the end you'll have invited the bot, run /quicksetup, and tested that the audit log and AI features are wired up correctly.

Before you start

You need three things in your Discord server before kesarAI can be useful:

  • Manage Server permission on your own account — the setup hub is owner-gated by default.
  • A dedicated mod-log channel. It can be private to staff or visible to everyone; kesarAI will respect whatever permissions you set on it.
  • A moderator role. If you don't have one yet, create it now — even an empty role works. Setup will ask you to point at it.

Invite the bot

Head to the install link and pick the server you want kesarAI in. Approve the requested permissions — kesarAI asks for the minimum it needs to moderate, send messages, manage channels, and read history.

Tip.If you're evaluating the bot first, drop it in a private staging server. Every feature is per-guild, so a test run won't leak any data into your main community.

Run /quicksetup

Once the bot is in your server, run /quicksetup in any channel you can see it. The command launches a short interactive flow that asks for the three essentials and then writes them to the config database.

/quicksetup
  → mod role:      @Moderators
  → log channel:   #mod-log
  → verify channel: #verify   (optional)

✓ Saved to config.db. You can re-run /setup anytime.

Quicksetup is intentionally short. Everything else — audit categories, AI point budgets, automod blocklists, the verify ticket system — lives behind /setup, where you can configure it when you actually need it.

The setup hub

Run /setupto open the central configuration motherboard. It's an interactive panel that links out to every cog's own setup view. Click a section and you'll be taken to a purpose-built editor with native role / channel / user selects — no typing IDs in chat.

The sections you'll find inside:

  1. Moderation — assign mod role permissions in a two-tier grid (Standard / AI).
  2. Logging — pick which audit categories mirror to Discord, and which channels they post to.
  3. AI quota — configure the universal point budget and per-command costs. (Owner only.)
  4. Tickets — verify ticket templates, transcripts, delayed delete behaviour.
  5. Automod — content filters, leetspeak bypass detection, the blocklist for /say.
  6. Fun — RPS and Connect Four scoreboards, emoji trivia channels.

Verify installation

The fastest smoke test is to run any moderation command and confirm it appears in your audit log channel. Try /note on yourself:

/note user:@you content:installation test
✓ Note added (case #1).

You should see a matching embed appear in the channel you configured during /quicksetup. If not, double-check that the bot has Send Messages and Embed Links permission in that channel — those are the two most common things servers forget.

Next steps

The bot is now running with sane defaults. From here, the two most useful pages are:

  • Permission tiers — give your mods access to the right commands without handing them the keys.
  • AI quota — understand the point budget that gates /ask, /think, /imagine, and friends.
prevOverviewnextPermission tiers