Discord AI Chat Bot

A Discord bot that integrates with OpenRouter APIs to provide AI chat capabilities. Features a web interface for managing multiple AI models and user-specific preferences.

Features

• AI Chat: Ask questions using /ask command with intelligent responses
• Conversation Memory: AI remembers previous conversations for context-aware responses
• Per-User Memory: Each user has their own separate conversation history
• Model Switching: Change AI models with /change command and autocomplete
• User Preferences: Each user maintains their own preferred AI model
• Web Interface: Flask web interface for managing models and settings
• Multiple Models: Support for unlimited OpenRouter AI models
• Real-time: Instant responses with comprehensive error handling
• Secure: Environment-based configuration with proper security practices

Discord Commands

Command	Description	Example
/ping	Check if the bot is working	/ping
/ask <content>	Ask the AI a question (remembers context)	/ask What is machine learning?
/change <model>	Change your preferred AI model	/change GPT-4
/models	Show available models and your current selection	/models
/clear_memory	Clear your conversation history	/clear_memory
/memory_info	View your conversation memory statistics	/memory_info

Quick Start

1. Install Dependencies

pip install -r requirements.txt

2. Environment Setup

Create a .env file in the root directory:

DISCORD_BOT_TOKEN=your_discord_bot_token_here
GUILD_ID=your_guild_id_here
FLASK_SECRET_KEY=your_secret_key_here

3. Discord Bot Configuration

1. Visit Discord Developer Portal
2. Create a new application
3. Navigate to the "Bot" section and create a bot
4. Copy the bot token to your .env file
5. Enable these bot permissions:
   • Send Messages
   • Use Slash Commands
   • Read Message History
6. Invite the bot to your server using the OAuth2 URL

4. OpenRouter API Setup

1. Sign up at OpenRouter
2. Obtain your API key from the dashboard
3. Use the web interface to add models with their official names

5. Launch the Bot

python run.py

The bot will automatically:

• Initialize the database
• Start the Flask web interface on http://localhost:5000
• Connect to Discord and sync slash commands

Web Interface

Access the web interface at http://localhost:5000 to manage your AI models:

Features

• Add Models: Configure new AI models with OpenRouter identifiers
• Edit Models: Modify existing model configurations
• Toggle Models: Enable/disable models for use
• Delete Models: Remove unused models

Adding Your First Model

1. Navigate to the web interface
2. Click "Add New Model"
3. Fill in the details:
   • Model Name: Friendly name (e.g., "GPT-4", "Claude-3")
   • Official Name: OpenRouter model identifier (e.g., "openai/gpt-4")
   • API Key: Your OpenRouter API key
4. Click "Add Model"

Usage Guide

For Users

1. Set Your Model: Use /change <model_name> to set your preferred model (autocomplete available)
2. Ask Questions: Use /ask <your question> to chat with the AI (remembers previous conversations)
3. Switch Models: Use /change <model_name> to select a different AI model
4. Check Models: Use /models to see available models and your current selection
5. Manage Memory:
   • Use /memory_info to view your conversation statistics
   • Use /clear_memory to reset your conversation history for a fresh start

For Administrators

1. Add Models: Use the web interface to add new AI models
2. Monitor Usage: Check the bot logs for any issues
3. Manage Models: Enable/disable models as needed

Project Structure

DiscordAIChatBot/
├── discord_bot.py          # Main Discord bot with memory
├── flask_web.py            # Flask web interface
├── openrouter_client.py    # OpenRouter API client
├── database.py             # Database models (includes ConversationHistory)
├── config.py               # Configuration
├── update_memory_database.py # Memory database migration script
├── requirements.txt        # Python dependencies
├── README.md              # This file
└── templates/             # Flask HTML templates
    ├── base.html
    ├── index.html
    ├── add_model.html
    └── edit_model.html

Tutorial

For a complete step-by-step setup guide, visit: Discord AI Setup Guide

This tutorial provides detailed instructions for:

• Discord bot creation and configuration
• Environment setup
• Memory functionality setup
• Local deployment
• Cloud deployment options

Memory Features

The bot now includes sophisticated conversation memory:

How It Works

• Each user has their own separate conversation history
• The AI remembers up to the last 10 message exchanges for context
• Memory persists across bot restarts and sessions
• Conversations are stored securely in the database

Memory Commands

• /ask: Now context-aware - the AI remembers your previous messages
• /memory_info: Shows your conversation statistics and recent message preview
• /clear_memory: Clears your conversation history for a fresh start

Privacy & Security

• Each user's conversations are completely separate and private
• Memory can be cleared at any time using /clear_memory
• No conversation data is shared between users
• All messages are stored locally in your database

Troubleshooting

Bot Not Responding

• Check if the bot token is correct
• Ensure the bot has proper permissions
• Verify the bot is online in Discord

AI Not Responding

• Check if the model is active in the web interface
• Verify the OpenRouter API key is correct
• Ensure the official model name is valid

Web Interface Not Loading

• Check if Flask is running on port 5000
• Ensure no other application is using the port
• Check the console for any error messages

Security Best Practices

• Keep your Discord bot token and API keys secure
• Never share your .env file
• Use strong, unique API keys for each model
• Regularly rotate your API keys
• Enable Railway's automatic HTTPS in production

Deployment

This bot is ready for deployment on Railway! See the deployment guides:

• DEPLOYMENT.md - Complete deployment guide
• DEPLOYMENT_CHECKLIST.md - Pre-deployment checklist

One-Click Deploy

Click the button above to deploy directly to Railway with our pre-configured template!

Template Features:

• AI/ML Category - Listed in Railway's AI/ML templates
• 3 Required Variables - Simple configuration
• Full-Stack Solution - Discord bot + web interface

Contributing

We welcome contributions! Feel free to:

• Submit bug reports
• Suggest new features
• Submit pull requests
• Improve documentation

License

This project is open source and available under the MIT License.