ChatGPT Discord Bot

Overview

Welcome to ChatGPT Discord Bot! This bot provides a powerful AI assistant for Discord users, powered by OpenAI's latest models. It not only generates text responses but also offers a range of advanced features including image generation, data analysis, web searching, and reminders. The bot is designed for easy deployment with Docker and includes CI/CD integration via GitHub Actions.

Features

• Advanced AI Conversations: Uses OpenAI's latest models (including openai/gpt-4o) for natural language interactions
• 🆕 Smart Model Selection: Automatically suggests the best AI model based on task type (coding, reasoning, creative, etc.)
• 🆕 User Preferences: Comprehensive personalization system for customizing bot behavior and settings
• 🆕 Conversation Management: Intelligent context management with automatic summarization for long conversations
• 🆕 Enhanced File Processing: Support for Word docs, PowerPoint, code files, and many more formats beyond PDF/CSV
• Image Generation: Creates custom images from text prompts using Runware's API
• Data Analysis: Analyzes CSV and Excel files with visualizations (distributions, correlations, box plots, etc.)
• Code Interpretation: Executes Python code for calculations and data processing
• Reminder System: Sets timed reminders with custom timezone support
• Web Tools:
  • Google Search: Searches the web and provides relevant information
  • Web Scraping: Extracts and summarizes content from websites
• PDF Analysis: Processes and analyzes PDF documents
• User Statistics: Tracks token usage and model selection per user
• 🆕 Enhanced Help System: Interactive help with feature discovery and detailed guides
• Dockerized Deployment: Ready for easy deployment with Docker
• Automated CI/CD: Integrated with GitHub Actions

Prerequisites

To get started, ensure you have:

• Docker (for containerized deployment)
• Python 3.12.7
• Discord Bot Token
• OpenAI API Key
• Runware API Key (Get yours at Runware)
• Google API Key and Custom Search Engine ID (CX)
• MongoDB URL (Get from https://cloud.mongodb.com/)

Setup

For Normal Use

Option A: Deploy with Docker

1. Create a .env file in the root directory with your configuration:

   DISCORD_TOKEN=your_discord_token
   OPENAI_API_KEY=your_openai_api_key
   RUNWARE_API_KEY=your_runware_api_key
   GOOGLE_API_KEY=your_google_api_key
   GOOGLE_CX=your_google_cx
   OPENAI_BASE_URL=https://api.openai.com/v1/models
   MONGODB_URI=mongodb://localhost:27017/
   ADMIN_ID=your_discord_user_id
   TIMEZONE=Asia/Ho_Chi_Minh
   

2. Use the following docker-compose.yml:

   version: '3.8'
   services:
     bot:
       image: ghcr.io/coder-vippro/chatgpt-discord-bot:latest
       env_file:
         - .env
       restart: always
   

3. Start the bot with:

   docker-compose up -d
   

Option B: Deploy Without Docker

1. Clone the repository:

   git clone https://github.com/Coder-Vippro/ChatGPT-Discord-Bot.git
   cd ChatGPT-Discord-Bot
   

2. Create a .env file in the root directory with your configuration:

   DISCORD_TOKEN=your_discord_token
   OPENAI_API_KEY=your_openai_api_key
   RUNWARE_API_KEY=your_runware_api_key
   GOOGLE_API_KEY=your_google_api_key
   GOOGLE_CX=your_google_cx
   OPENAI_BASE_URL=https://api.openai.com/v1/models
   MONGODB_URI=mongodb://localhost:27017/
   ADMIN_ID=your_discord_user_id
   TIMEZONE=Asia/Ho_Chi_Minh
   

3. Install the dependencies:

   pip install -r requirements.txt
   

4. Run the bot:

   python3 bot.py
   

For Development

1. Clone the repository:

   git clone https://github.com/Coder-Vippro/ChatGPT-Discord-Bot.git
   cd ChatGPT-Discord-Bot
   

2. Install dependencies:

   pip install -r requirements.txt
   

3. Run the bot:

   python3 bot.py
   

Running Tests

1. Install test dependencies:

   pip install pytest
   

2. Run tests:

   pytest tests/
   

Usage

Once the bot is running, it connects to Discord using credentials from .env. Available features include:

🆕 What's New - Enhanced Features

This bot now includes several powerful enhancements to improve your experience:

🧠 Smart Model Selection

The bot automatically analyzes your request and suggests the best AI model:

• Coding tasks → openai/gpt-4o or openai/o1-preview
• Complex reasoning → openai/o1-preview or openai/o1
• Creative writing → openai/gpt-4o or openai/gpt-4o-mini
• Quick questions → openai/gpt-4o-mini

⚙️ Personalization

Customize your bot experience with /preferences:

• Set your preferred AI model
• Choose response style (balanced, concise, detailed)
• Enable/disable automatic features
• Configure language and timezone preferences

📊 Conversation Management

• Automatic conversation summarization for long chats
• Token usage monitoring with /conversation_stats
• Smart context management to maintain conversation quality

📁 Enhanced File Processing

Process many more file types with /process_file:

• Documents: Word (.docx), PowerPoint (.pptx), Markdown
• Data: JSON, YAML, advanced CSV/Excel analysis
• Code: Python, JavaScript, HTML, CSS, and more
• Logs: Error analysis and insights

For detailed information, see ENHANCEMENTS.md or use /help_enhanced in Discord.

Text Commands

• Normal chat: Ping the bot with a question or send a DM to start a conversation
• 🆕 Smart Model Selection: The bot automatically suggests the best AI model for your task
• Image Generation: /generate prompt: "A futuristic cityscape"
• Web Content: /web url: "https://example.com"
• Google Search: /search prompt: "latest news in Vietnam"
• 🆕 Personalization: /preferences set response_style detailed to customize your experience
• 🆕 File Processing: /process_file to analyze Word docs, PowerPoint, code files, and more
• 🆕 Smart Help: /help_enhanced for detailed feature discovery and guides
• User Statistics: /user_stat - Get your token usage and model information
• 🆕 Conversation Stats: /conversation_stats - Monitor your conversation health and token usage

Advanced Features

• 🆕 Smart Model Selection: Automatically chooses the optimal AI model based on your task type
• 🆕 User Preferences: Customize response style, enable/disable features, set default models
• 🆕 Conversation Management: Automatic summarization of long conversations to maintain context
• 🆕 Enhanced File Support: Process Word documents, PowerPoint presentations, code files, JSON, YAML, and more
• Data Analysis: Upload CSV or Excel files for automatic analysis and visualization
• Code Execution: The bot can execute Python code to solve problems or create visualizations
• Reminders: Ask the bot to set reminders like "Remind me to check email in 30 minutes"
• PDF Analysis: Upload PDF documents for the bot to analyze and summarize

Available Models

The bot supports the following models:

• openai/gpt-4o
• openai/gpt-4o-mini
• openai/o1-preview
• openai/o1-mini
• openai/o1
• openai/o3-mini

Environment Variables

Variable	Description	Default
DISCORD_TOKEN	Your Discord bot token	Required
OPENAI_API_KEY	Your OpenAI API key	Required
RUNWARE_API_KEY	Runware API key for image generation	Required
GOOGLE_API_KEY	Google API key for search	Required
GOOGLE_CX	Google Custom Search Engine ID	Required
MONGODB_URI	MongoDB connection string	Required
ADMIN_ID	Discord user ID of the admin	Optional
TIMEZONE	Timezone for reminder feature	UTC
ENABLE_WEBHOOK_LOGGING	Enable webhook logging	False
LOGGING_WEBHOOK_URL	URL for webhook logging	Optional

CI/CD

This project uses GitHub Actions for CI/CD, with workflows in .github/workflows.

Security

For supported versions and vulnerability reporting, see SECURITY.md.

Contributing

Please read our Code of Conduct before contributing to this project.

License

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

---

Made with ❤️ by coder-vippro