A powerful, feature-rich WhatsApp bot built on Baileys library for comprehensive group management and entertainment. This enhanced version includes advanced features, improved stability, and extensive customization options.
Love this project? Your support helps keep it alive and growing!
- ๏ฟฝ๐ Quick Start
- โจ Features
- ๐ ๏ธ Installation
- ๐ Commands List
- ๐ง Configuration
- ๐ฏ Advanced Features
- ๐ค Contributing
- ๐ License
- ๐ Credits
Get your Knight Bot up and running in minutes!
Click the button below to fork the Knight Bot repository to your GitHub account:
Deploy the bot and easily connect it to your WhatsApp account by pair code. Click the button below to deploy the bot on Replit.
For further customization and setup guidance, click the button below:
We welcome contributions from the community! Here's how you can help:
- Check existing issues
- Create a detailed bug report with steps to reproduce
- Include system information and error logs
- Open a feature request
- Describe the feature and its benefits
- Provide examples or mockups if possible
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature - Make your changes with proper comments
- Test thoroughly
- Submit a pull request
- Improve existing documentation
- Add usage examples
- Translate documentation to other languages
This project is built upon the foundation of Knightbot-MD by mruniquehacker. The original codebase had several issues which have been fixed and significantly enhanced in this version.
- Fixed broken features from the original codebase
- Added 50+ new commands for enhanced functionality
- Improved stability and error handling
- Enhanced security features for better group protection
- Modern UI/UX for better user experience
- Comprehensive documentation and setup guides
- Baileys Library: For WhatsApp Web API integration
- Node.js Community: For excellent package ecosystem
- Contributors: Everyone who has contributed to improving this project
- Users: For feedback, bug reports, and feature requests
- Bot images and stickers from the original Knightbot-MD project
- Icons and badges from Shields.io
- Typing animation from Typing SVG
- 80+ Commands across different categories
- 15+ Games for entertainment
- 10+ Admin Tools for group management
- 20+ Media Features for content creation
- Multiple Languages support for global usage
If this project has helped you, consider supporting its development:
- โญ Star this repository on GitHub
- ๐ Report bugs and suggest improvements
- ๐ข Share with friends and colleagues
- ๐ Contribute code or documentation
- ๐ฌ Join our community discussions
- Interactive Games: Tic-Tac-Toe, Trivia, Hangman, Truth or Dare
- Fun Commands: Jokes, Memes, 8-Ball predictions, Ship compatibility
- Creative Tools: Sticker creation, ATTP text, Emoji mix
- Admin Controls: Kick, Ban, Mute, Warn members
- Moderation: Anti-link, Anti-bad words, Anti-delete
- Member Management: Promote, Demote, Tag all members
- Group Info: Member statistics, Group information
- Music: Play songs, Download audio from YouTube
- Social Media: Download from Instagram, TikTok, Facebook
- Text-to-Speech: Convert text to voice messages
- Image Tools: Create quotes, Generate AI images
- Weather: Get weather information for any city
- Translation: Translate text between languages
- QR Codes: Generate and read QR codes
- News: Get latest news updates
- Search: Google search, GitHub repositories
- Auto-Status: Automatic status viewing
- Reminders: Set personal reminders
- Welcome/Goodbye: Custom messages for new/leaving members
- Session Management: Secure session handling
Ensure you have the following installed:
- Node.js (v16.x or higher)
- Git (for repository cloning)
- npm or yarn (package manager)
-
Clone the Repository
git clone https://github.com/wambugu71/whatsapp_bot.git cd whatsapp_bot -
Install Dependencies
npm install
-
Configure Settings
- Edit
config.jswith your preferences - Customize
settings.jsfor advanced options
- Edit
-
Start the Bot
npm start # or node index.js -
Connect WhatsApp
- Scan the QR code with WhatsApp (Linked Devices)
- Or use the pair code method (see deployment section)
| Command | Description | Usage |
|---|---|---|
.help |
Show all available commands | .help |
.alive |
Check if bot is active | .alive |
.ping |
Check bot response time | .ping |
.owner |
Get owner information | .owner |
| Command | Description | Usage |
|---|---|---|
.tagall |
Tag all group members | .tagall [message] |
.kick |
Remove member from group | .kick @user |
.ban |
Ban user from using bot | .ban @user |
.mute |
Mute group member | .mute @user |
.warn |
Warn a member | .warn @user [reason] |
.promote |
Promote to admin | .promote @user |
.demote |
Remove admin privileges | .demote @user |
| Command | Description | Usage |
|---|---|---|
.tictactoe |
Start tic-tac-toe game | .tictactoe @player2 |
.trivia |
Start trivia quiz | .trivia |
.hangman |
Play hangman game | .hangman |
.joke |
Get random joke | .joke |
.meme |
Get random meme | .meme |
.8ball |
Magic 8-ball predictions | .8ball [question] |
| Command | Description | Usage |
|---|---|---|
.play |
Play/download music | .play [song name] |
.video |
Download video | .video [url] |
.instagram |
Download Instagram media | .instagram [url] |
.tiktok |
Download TikTok video | .tiktok [url] |
.sticker |
Create sticker from image | .sticker (reply to image) |
| Command | Description | Usage |
|---|---|---|
.weather |
Get weather info | .weather [city] |
.translate |
Translate text | .translate [lang] [text] |
.qr |
Generate QR code | .qr [text] |
.news |
Get latest news | .news |
.google |
Google search | .google [query] |
module.exports = {
// Bot Settings
botName: "Knight Bot",
ownerName: "Your Name",
ownerNumber: "your-number@s.whatsapp.net",
// API Keys (Optional)
openWeatherAPI: "your-api-key",
newsAPI: "your-api-key",
// Bot Behavior
autoRead: true,
autoStatus: false,
publicMode: false
};- Customize command prefixes
- Set group-specific settings
- Configure auto-responses
- Manage banned words list
- ChatGPT Integration: Intelligent conversations with AI
- Character AI: Role-play with different characters
- Image Generation: Create AI-generated images
- Anti-Link Protection: Automatically delete suspicious links
- Bad Word Filter: Filter inappropriate content
- Auto-Delete Protection: Track deleted messages
- Spam Protection: Rate limiting for commands
- Message Count Tracking: Monitor group activity
- User Statistics: Track individual user engagement
- Command Usage Analytics: See most used features
- Performance Monitoring: Bot health and response times
- Auto-Welcome: Greet new members automatically
- Auto-Goodbye: Say farewell to leaving members
- Scheduled Reminders: Set personal reminders
- Auto-Status View: Automatically view contacts' status
This project is licensed under the MIT License - see the LICENSE file for details.
- โ Use for personal and commercial purposes
- โ Modify and distribute freely
- โ Include original license and copyright notices
- โ Remove author attribution
- โ Use for spam or malicious purposes
- Educational Purpose: This bot is created for educational and legitimate group management purposes
- Not Official: This is NOT an official WhatsApp bot or endorsed by WhatsApp Inc.
- Account Risk: Using automation bots may violate WhatsApp's Terms of Service
- Use Responsibly: Users are responsible for compliance with local laws and WhatsApp policies
- No Liability: Developers assume no responsibility for account bans or legal issues
- Don't Spam: Avoid sending bulk or unwanted messages
- Respect Privacy: Don't use for harassment or privacy violations
- Follow Laws: Ensure compliance with local regulations
- Group Consent: Get permission before adding bot to groups
- Regular Updates: Keep bot updated for security patches
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Email: Create an issue for contact information
