README

OpenAI-powered auto-moderation for Flarum. Scans posts, discussion titles, usernames, avatars, uploads, bios, and polls using the OpenAI Moderation API (omni-moderation-latest).

Features

Text + Image moderation in a single API call (omni-moderation-latest)
12 harm categories with per-category thresholds and configurable actions (flag / hide / delete / warn)
Async queue mode — dispatch to Laravel queue for high-traffic forums
Trust score system — high-trust users skip moderation; low-trust users always get synchronous checks
Admin review queue — approve or reject flagged items from the admin panel
Bridge extensions — integrates with flarum/flags, fof/polls, fof/user-bio, fof/upload, blomstra/flarum-ext-upload, fof/profile-image-crop
Webhook notifications — POST JSON to any endpoint on every flagged item
Retrospective scan — Artisan command to scan existing content

Requirements

Flarum >= 2.0 (for ^2.0 tag) or Flarum >= 1.8 (for ^1.0 tag)
PHP >= 8.2 (for Flarum 2.0)
OpenAI API key

Installation

For Flarum 2.x (Recommended)

composer require tapao/auto-ai-moderation
php flarum migrate
php flarum assets:publish

For Flarum 1.x

composer require tapao/auto-ai-moderation:^1.0
php flarum migrate
php flarum assets:publish

No Node.js required for installation — the compiled JS is included in the package.

Development (frontend changes only)

cd js
npm install
npm run dev    # watch mode
npm run build  # production build — commit js/dist/admin.js afterward

Configuration

Go to Admin → Extensions → ModerationAI and enter your OpenAI API key.

Artisan scan

php flarum moderationai:scan --type=post --limit=500 --since=2024-01-01

License

MIT

tapao / auto-ai-moderation

Maintainers

Package info

Statistics

Security