🤖 Iris Discord AI Bot

Intelligent Discord AI Bot with Multi-Provider Support & Advanced Moderation

🚀 Add to Server • 📖 Self-Host Guide • ⚙️ Configuration • 🤝 Contributing

---

📖 About

Iris is a powerful Discord AI bot that integrates multiple AI providers (Gemini, OpenAI, Groq) with advanced conversation capabilities, intelligent moderation, and rich media processing.

✨ Key Features

• 🧠 Multi-AI Provider Support - Seamlessly switch between Gemini, OpenAI, and Groq
• 🛡️ AI-Powered Moderation - Natural language command processing for server management
• 🌐 URL Context Analysis - Analyze web content directly in conversations
• 📱 Rich Media Processing - Image and video analysis with AI vision
• 💾 Conversation Memory - Persistent chat history with SQLite
• 🔑 Personal API Keys - Users can set their own API keys for unlimited usage

🚀 Quick Start

Prerequisites

• Node.js 18.0.0 or higher
• Discord Bot Token
• AI API Key

Installation

# Clone and install
git clone https://github.com/bm-hien/Iris-Discord-AI.git
cd Iris-Discord-AI
npm install

# Configure environment
cp .env.example .env
# Edit .env with your tokens

# Start the bot
npm start

⚙️ Configuration

Edit your .env file:

# Discord (Required)
DISCORD_BOT_TOKEN=your_discord_bot_token
DISCORD_CLIENT_ID=your_bot_client_id

# AI Configuration
DEFAULT_AI_PROVIDER=gemini
DEFAULT_GEMINI_API_KEY=your_gemini_api_key

# Optional: Additional Providers
DEFAULT_OPENAI_API_KEY=your_openai_api_key
DEFAULT_GROQ_API_KEY=your_groq_api_key

📖 Commands

Basic Usage

• Simply mention the bot or send a message to start chatting
• Use /apikey set to configure your personal API key
• Use /model set to switch between AI models
• Use /clear-history to reset conversation history

Moderation (Natural Language)

• "Mute @user for spamming"
• "Clear 10 messages"
• "Lock this channel"
• "Ban @user for harassment"

🏗️ Architecture

AI/
├── ai.js                    # Main AI module
├── functions/               # Core AI processing
│   ├── generateResponse.js  # AI response generation
│   ├── mediaProcessor.js    # Image/video processing
│   └── functionCalling.js   # Discord function integration
├── commands/                # AI command processing
└── events/                  # Database & system management

🤝 Contributing

We welcome contributions! Please check our issues for ways to help.

📄 License

This project is licensed under the MIT License - see LICENSE file for details.

🔗 Links

• 🤖 Add Public Bot: Invite to your server
• 📚 Documentation: Online Docs
• 🐛 Bug Reports: Create an issue
• 💡 Feature Requests: Submit suggestions
• 💬 Support: Join our Discord
• ☕ Support Development: Buy me a coffee

---

Made with ❤️ by Bmhien

Bringing AI-powered intelligence to Discord communities worldwide

☕ Support the project