-
Notifications
You must be signed in to change notification settings - Fork 2
Home
pancakes-proxy edited this page Jul 14, 2025
·
2 revisions
Welcome to the comprehensive documentation for AIMod, an advanced AI-powered Discord moderation bot that provides intelligent, automated moderation capabilities for Discord servers.
- Architecture Overview - System architecture and component relationships
- AI Moderation System - Core AI moderation capabilities and processing flow
- Database System - PostgreSQL database structure and operations
- Dashboard System - Web dashboard for bot management
- Cogs and Commands - Complete command reference and cog documentation
- Configuration System - Guild settings and channel-specific configuration
- Security Features - Bot detection, raid defense, and global ban system
- Logging and Analytics - Comprehensive logging and statistics system
- Installation Guide - Complete setup instructions
- Production Deployment - Production environment setup
- Database Migration - PostgreSQL migration from JSON
- Developer Guide - Development setup and contribution guidelines
AIMod is a sophisticated Discord moderation bot that leverages artificial intelligence to automatically moderate Discord servers. Built with Python and Discord.py, it provides:
- 🤖 AI-Powered Moderation: Uses LiteLLM with multiple AI providers for intelligent content analysis
- 🛡️ Advanced Security: Bot detection, raid defense, and global ban management
- 📊 Web Dashboard: React-based dashboard for configuration and analytics
- 🗄️ PostgreSQL Backend: Robust database system with Redis caching
- ⚙️ Flexible Configuration: Per-guild and per-channel customization
- 📈 Analytics & Logging: Comprehensive moderation statistics and logging
- Modular Cog System: Organized functionality into discrete cogs
- Async/Await: Full asynchronous operation for optimal performance
- RESTful API: FastAPI backend for dashboard integration
- Scalable Design: Auto-sharded bot supporting multiple servers
- Production Ready: Systemd services, Nginx configuration, and monitoring
- Backend: Python 3.11+, Discord.py, FastAPI, PostgreSQL, Redis
- Frontend: React, TypeScript, Tailwind CSS
- AI Integration: LiteLLM (OpenRouter, GitHub Copilot, multiple providers)
- Infrastructure: Nginx, Cloudflared, Systemd
- Development: Pytest, Black, Pre-commit hooks
- Intelligent message analysis using state-of-the-art language models
- Context-aware decision making with server rules integration
- Support for text, images, and media content analysis
- Customizable moderation actions (warn, timeout, ban)
- Appeal system for moderation decisions
- Real-time bot detection and automated responses
- Raid defense with configurable thresholds and actions
- Global ban system for severe violations across servers
- Rate limiting and spam protection
- Whitelist management for trusted users and roles
- Comprehensive web dashboard for server administrators
- Real-time moderation statistics and analytics
- User infraction tracking and history
- Command usage analytics and performance metrics
- Advanced logging with webhook integration
This wiki is organized into several main sections:
- Core Systems: Architecture, AI moderation, database, and dashboard
- Feature Documentation: Detailed coverage of all bot features and commands
- Configuration: Setup and customization guides
- Deployment: Production setup and maintenance
- Development: Contributing and extending the bot
Each section provides both high-level overviews and detailed technical documentation suitable for administrators, developers, and contributors.
- GitHub Repository - Source code and issues
- Discord Server - Community support
- OpenGuard Site - Official website
- API Documentation - REST API reference
Last updated: 2025-01-13 Documentation for AIMod v2.0.0