🎯 LeetCode Daily Challenge Discord Bot

A modern Discord bot that automatically fetches and shares LeetCode daily challenges

✨ Features

• 🔄 Automatic Daily Challenge: Automatically retrieves and posts LeetCode daily challenges
• ⏰ Scheduled Delivery: Configurable posting time for each server
• 🎮 Slash Commands: Easy-to-use slash commands for manual control
• 📊 Rich Information: Includes title, difficulty, link, tags, and more
• 🌐 Multi-server Support: Independent settings for each Discord server
• 🔔 Custom Notifications: Configurable role mentions and channels
• 🌍 Timezone Support: Server-specific timezone settings
• 📅 Historical Challenges: View past daily challenges by date
• 🔍 Problem Lookup: Query any LeetCode problem by ID
• 📈 Submission Tracking: View recent accepted submissions for any user
• 🤖 AI-Powered Features: Optional problem translation and inspiration (requires Gemini API key)
• 💾 Smart Caching: Efficient caching system for better performance

🚀 Quick Start

1. Clone the repository:

   git clone https://github.com/cxyfer/leetcode-daily-discord-bot.git
   cd leetcode-daily-discord-bot

2. Configure your bot:

   # Copy and edit the configuration file
   cp config.toml.example config.toml
   # Edit config.toml with your settings
   
   # Alternative: Use environment variables (.env)
   cp .env.example .env
   # Edit .env with your Discord bot token

3. Run database migration (if upgrading from older version):

   # Migrate server settings from settings.db to data.db
   sqlite3 data/data.db < data/migrate_settings.sql

4. Run the bot:

   uv run bot.py

🛠️ Configuration

Configuration Methods

The bot supports two configuration methods:

1. TOML Configuration (Recommended)

Create a config.toml file from the example:

[discord]
token = "your_discord_bot_token_here"

[llm.gemini]
api_key = "your_google_gemini_api_key_here"  # Optional, for AI features

[schedule]
post_time = "00:00"  # Default posting time
timezone = "UTC"     # Default timezone

See config.toml.example for all available options.

2. Environment Variables

For backward compatibility, you can use a .env file:

DISCORD_TOKEN=your_bot_token_here
GOOGLE_GEMINI_API_KEY=your_gemini_api_key_here  # Optional
POST_TIME=00:00  # Optional
TIMEZONE=UTC     # Optional

Note: Environment variables take precedence over config.toml settings.

Required Bot Permissions

• Send Messages
• Embed Links
• Use Slash Commands

Required Intents

• Message Content - Receive message content
  • Note: When the bot joins more than 100 servers, this permission needs to be verified and approved by Discord

📝 Usage

Slash Commands

Command	Description	Required Permissions
/daily [date] [public]	Display LeetCode.com (LCUS) daily challenge • Optional: YYYY-MM-DD for historical challenges • Optional: public - Show response publicly (default: private) • Note: Historical data available from April 2020 onwards	None
/daily_cn [date] [public]	Display LeetCode.cn (LCCN) daily challenge • Optional: YYYY-MM-DD for historical challenges • Optional: public - Show response publicly (default: private)	None
/problem <id> [domain] [public]	Query any LeetCode problem by ID • id: Problem number (1-4000) • domain: com or cn (default: com) • public: Show response publicly (default: private)	None
/recent <username> [limit] [public]	View recent accepted submissions for a user • username: LeetCode username (LCUS only) • limit: Number of submissions (1-50, default: 20) • public: Show response publicly (default: private)	None
/set_channel	Set notification channel for daily challenges	Manage Channels
/set_role	Set role to mention with daily challenges	Manage Roles
/set_post_time	Set posting time (HH:MM format)	Manage Guild
/set_timezone	Set server timezone for scheduling	Manage Guild
/show_settings	Display current server settings	None
/remove_channel	Remove channel settings	Manage Channels

Command Examples

Daily Challenge Commands

/daily                    # Get today's LeetCode.com challenge (private)
/daily public:true        # Get today's challenge and show response publicly
/daily date:2024-01-15    # Get historical challenge from Jan 15, 2024

Problem Lookup

/problem problem_id:1     # Get Two Sum problem from LeetCode.com (private)
/problem problem_id:1 public:true     # Get Two Sum problem publicly

Recent Submissions

/recent username:alice              # View 20 recent submissions (private)
/recent username:alice limit:50     # View 50 recent submissions
/recent username:alice limit:50 public:true  # View 50 submissions publicly

Server Configuration

/set_channel              # Set current channel for daily notifications
/set_role                 # Configure role to ping
/set_post_time time:08:00 # Set daily post time to 8:00 AM
/set_timezone timezone:America/New_York  # Set timezone
/show_settings            # View current configuration

Server Configuration Steps

1. Set up notification channel using /set_channel (Required)
2. Configure role mentions with /set_role (Optional)
3. Set posting time and timezone (Optional)
4. Verify settings with /show_settings

🗺️ Development Roadmap

• 🎮 Enhanced Command Interface
  • Add slash command prompts
  • Reply in the same channel where slash commands are used
  • Add /problem command for querying problems by ID
  • Add /recent command for viewing user submissions
  • Support historical daily challenges with date parameter
• ⚙️ Advanced Configuration System
  • Allow admin users to set the configuration
    • Set the channel to post the daily challenge
    • Set the posting time and timezone
    • Set the role to mention
    • Set customizable message templates
    • Integrate the existing excessive setup instructions
    • More flexible notification settings
• 🌐 Multi-server Infrastructure
  • Support server-specific configurations
• 📝 Code Optimization
  • Implement improved runtime logging
  • Implement modular architecture
  • Add comprehensive documentation
• 🇨🇳 LeetCode.cn Integration
  • Add slash command /daily_cn for LeetCode.cn daily challenge
  • Implement separate scheduler for LeetCode.cn challenges
• 🗄️ Database Integration
  • Store and query problem information in database
  • Enable historical daily challenge lookup
• 🔍 Large Language Model Integration
  • Integrate LLM to generate problem translation and inspiration
  • Cache LLM results to improve performance
• 📊 User Engagement Features
  • Track submission records of specific users
  • Interactive navigation for viewing multiple submissions
  • Paginated display with clean UI
  • Allow users to configure tracked LeetCode accounts
  • Implement server-wide submission leaderboards
• 🐳 Containerization Support
  • Add Docker compose file and image
• 🌍 Internationalization
  • Support multiple display languages

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

📦 Dependencies

• discord.py - Discord bot framework
• tomli - TOML parsing for Python < 3.11
• python-dotenv - Environment variable management
• requests - HTTP library for API calls
• pytz - Timezone handling
• beautifulsoup4 - HTML parsing
• colorlog - Colored logging output
• langchain - LLM application framework
• langchain-google-genai - Google Gemini LLM integration
• aiohttp - Asynchronous HTTP client/server

📄 License

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