Every AI feature is off by default. A server owner opts in per feature (and can scope each feature to specific channels) from the AI tab of the dashboard. With everything off, Percy behaves exactly as it always has.
What the AI layer adds
Assistant
Ask Percy questions with
/ask. Replies thread into a conversation, and Percy can hand you a button to run the real command it recommends.Smart commands
Phrase polls, giveaways, music, and tag lookups in plain language — Percy fills in the structured details for you.
Moderation signal
An opt-in review signal that flags potentially harmful messages for a human. It never punishes anyone on its own.
Self-hosting
Run the model yourself. Nothing is sent to a third-party AI provider.
How it behaves
Three principles govern every AI feature:- Off by default, opt-in per server. Each feature has its own toggle, plus optional per-channel overrides. You turn on only what you want, only where you want it.
- Graceful fallback. If the model is disabled, unreachable, slow, or unsure, Percy silently falls back to its normal behavior. An AI hiccup never breaks a command or shows an error.
- AI suggests, it never acts irreversibly. The AI extracts structured details, answers questions, and flags messages for review. Bans, kicks, and deletions always stay behind the existing commands and human review.
Privacy
The model runs on Percy’s own server — message text is processed locally and is not sent to any third-party AI provider, and not stored for training. See the Privacy Policy and the self-hosting guide for details.Enabling AI
1
Open the dashboard
Go to percy.klappstuhl.me/dashboard, pick your server, and open the AI tab.
2
Toggle the features you want
Enable any of: assistant, smart commands (router, music, polls, giveaways, tags), and the moderation signal. Each is independent.
3
Scope to channels (optional)
Add per-channel overrides if you want a feature only in certain channels — for example, the assistant only in
#ask-percy.