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 >= 1.8.0
• PHP >= 8.1
• OpenAI API key

Installation

composer require tapao/auto-ai-moderation
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