tapao/auto-ai-moderation

OpenAI-powered auto-moderation for Flarum

Maintainers

Package info

github.com/Tapao-NonSen/Auto-AI-Moderation

Type:flarum-extension

pkg:composer/tapao/auto-ai-moderation

Transparency log

Statistics

Installs: 15

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

v1.0.5 2026-06-26 17:29 UTC

Requires

Suggests

  • blomstra/flarum-ext-upload: Moderate file uploads before storage
  • flarum/flags: AI flags appear in the moderator flag queue
  • flarum/suspend: Warn action falls back to temporary suspension
  • fof/byobu: Moderate private messages
  • fof/polls: Moderate poll options
  • fof/profile-image-crop: Moderate cover photos
  • fof/upload: Alternative upload extension — same bridge
  • fof/user-bio: Moderate bio field
  • fof/warnings: Warn action issues real fof/warnings strikes

MIT dc889a5f90418c8fa7ea4ec58054a08d4a0835c5

Published on Packagist.org on 2026-06-26 17:30 UTC

This package is auto-updated.

Last update: 2026-06-27 17:06:26 UTC

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