Core Dev Group Bot

A next-generation AI-powered Discord Bot & Web Dashboard built to manage, moderate, and scale developer communities.

🌟 Features

Core Dev Group Bot is packed with features designed specifically for developers, community managers, and tech enthusiasts.

🤖 AI Integration (Powered by Gemini)

• Conversational AI: Tag the bot in designated channels to ask coding questions or chat normally. The AI remembers up to 10 previous messages for context!
• AI Code Review: Drop a code snippet inside the #tech-talks channel and get instant, constructive feedback and best-practice suggestions from the AI.
• Smart GitHub Summaries: Converts complex GitHub commit logs and PRs into easy-to-read, conversational updates.

🛡️ Smart Auto-Moderator

• Toxicity Filter: AI-powered blocklist that automatically scans and removes toxic messages.
• Configurable Punishments: Automatically warns, timeouts, kicks, or bans members who violate the rules (configurable via the Dashboard).
• Immunity System: Set roles or channels to be immune from AutoMod actions.

🌐 Full-Stack Web Dashboard

• Module Toggles: Turn specific bot features (Leveling, AutoMod, Kanban, Code Review) ON or OFF dynamically.
• Customizable Messages: Edit Welcome, Level-Up, and AutoMod warning messages directly from the web interface.
• Live Statistics: Displays real-time metrics including total members, bot uptime, and total commands served.
• Discord OAuth2: Secure login using Discord accounts.

🚀 Developer Tools & Kanban

• Tech Lookups: Instantly search for NPM packages (!npm), GitHub repositories (!github), and MDN documentation (!mdn) directly from Discord.
• In-Discord Kanban Board: Create, list, complete, and delete tasks (!task add, !task list) to manage team workflows natively inside Discord.

🎮 Leveling & Profiles

• Interactive Gamification: Users gain XP by chatting. Generate aesthetic rank cards using !rank (Powered by Canvacord v6).
• Custom Profiles: Link your GitHub (!setgithub) and write a bio (!setbio) to showcase your developer portfolio via !profile.

---

🛠️ Tech Stack

• Backend: Node.js, Express.js, Discord.js v14
• Database: MongoDB (Mongoose)
• Frontend: React, Vite, TailwindCSS (Vanilla CSS implementation)
• AI Integration: Google Gen AI SDK (Gemini)
• Image Generation: Canvacord v6

---

🚀 Getting Started

Prerequisites

• Node.js (v18 or newer)
• A MongoDB Database (Local or Atlas)
• A Discord Bot Token
• A Google Gemini API Key

Installation

1. Clone the repository:

   git clone https://github.com/core-dev-group/core-dev-group-bot.git
   cd core-dev-group-bot

2. Install Backend Dependencies:

   npm install

3. Install Frontend Dependencies:

   cd web
   npm install
   cd ..

4. Environment Setup: Create a .env file in the root directory and add the following:

   DISCORD_TOKEN=your_discord_bot_token
   MONGODB_URI=your_mongodb_connection_string
   GEMINI_API_KEY=your_gemini_api_key
   PORT=3000
   CLIENT_ID=your_discord_client_id
   CLIENT_SECRET=your_discord_client_secret
   FRONTEND_URL=http://localhost:5173
   JWT_SECRET=your_secure_jwt_secret

5. Run the Application: Open two terminals.

   Terminal 1 (Backend/Bot):

   npm start

   Terminal 2 (Web Dashboard):

   cd web
   npm run dev

6. Access the Dashboard: Visit http://localhost:5173 in your browser.

---

📜 Documentation

Full documentation on how to configure the bot, setup specific channels, and manage the Kanban board is available directly on the Web Dashboard.

🤝 Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

📄 License

This project is licensed under the MIT License.