Skip to content

wambugu71/whatsapp_bot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

3 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿค– Knight Bot Kenny revised

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.

GitHub Stars GitHub Forks GitHub Issues License

๐Ÿ’ Support Development

Love this project? Your support helps keep it alive and growing!

Buy Me a Coffee ย ย  PayPal

๏ฟฝ Table of Contents


๐Ÿš€ Quick Start

Get your Knight Bot up and running in minutes!

Step 1: Fork the Repository

Click the button below to fork the Knight Bot repository to your GitHub account:


Step 2: Get Pair Code

Deploy the bot and easily connect it to your WhatsApp account by pair code. Click the button below to deploy the bot on Replit.

After getting creds.json file, upload it to session folder


Step 3: Deploy Now

For further customization and setup guidance, click the button below:

Deploy Now on Cloud Platforms


๐Ÿค Contributing

We welcome contributions from the community! Here's how you can help:

๐Ÿ› Reporting Bugs

  1. Check existing issues
  2. Create a detailed bug report with steps to reproduce
  3. Include system information and error logs

๐Ÿ’ก Suggesting Features

  1. Open a feature request
  2. Describe the feature and its benefits
  3. Provide examples or mockups if possible

๐Ÿ”ง Code Contributions

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/amazing-feature
  3. Make your changes with proper comments
  4. Test thoroughly
  5. Submit a pull request

๐Ÿ“ Documentation

  • Improve existing documentation
  • Add usage examples
  • Translate documentation to other languages

๐Ÿ™ Credits & Acknowledgments

๐ŸŽฏ Primary Credit

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.

๐Ÿ”ง Enhancements & Fixes

  • 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

๐ŸŒŸ Special Thanks

  • 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

๐ŸŽจ Assets & Resources

  • Bot images and stickers from the original Knightbot-MD project
  • Icons and badges from Shields.io
  • Typing animation from Typing SVG

๐Ÿ“Š Project Statistics

Repository Stats

๐Ÿš€ Features Count

  • 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

๐ŸŒŸ Star History


๐Ÿ’ Support the Project

If this project has helped you, consider supporting its development:

Remember: to support Buy Me a Coffee or PayPal

๐ŸŽฏ Other Ways to Support

  • โญ Star this repository on GitHub
  • ๐Ÿ› Report bugs and suggest improvements
  • ๐Ÿ“ข Share with friends and colleagues
  • ๐Ÿ“ Contribute code or documentation
  • ๐Ÿ’ฌ Join our community discussions

โœจ Features

๐ŸŽฎ Entertainment & Games

  • 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

๐Ÿ‘ฅ Group Management

  • 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

๐ŸŽต Media & Entertainment

  • 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

๐Ÿ”ง Utility Features

  • 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

๐Ÿ›ก๏ธ Security & Automation

  • Auto-Status: Automatic status viewing
  • Reminders: Set personal reminders
  • Welcome/Goodbye: Custom messages for new/leaving members
  • Session Management: Secure session handling

๐Ÿ› ๏ธ Installation

Prerequisites

Ensure you have the following installed:

  • Node.js (v16.x or higher)
  • Git (for repository cloning)
  • npm or yarn (package manager)

Step-by-Step Installation

  1. Clone the Repository

    git clone https://github.com/wambugu71/whatsapp_bot.git
    cd whatsapp_bot
  2. Install Dependencies

    npm install
  3. Configure Settings

    • Edit config.js with your preferences
    • Customize settings.js for advanced options
  4. Start the Bot

    npm start
    # or
    node index.js
  5. Connect WhatsApp

    • Scan the QR code with WhatsApp (Linked Devices)
    • Or use the pair code method (see deployment section)

๐Ÿ“– Commands List

๐ŸŽฏ General Commands

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

๐Ÿ‘‘ Admin Commands (Group Admins Only)

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

๐ŸŽฎ Games & Fun

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]

๐ŸŽต Media Commands

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)

๐Ÿ”ง Utility Commands

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]

๐Ÿ”ง Configuration

Basic Configuration (config.js)

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
};

Advanced Settings (settings.js)

  • Customize command prefixes
  • Set group-specific settings
  • Configure auto-responses
  • Manage banned words list

๐ŸŽฏ Advanced Features

๐Ÿค– AI Integration

  • ChatGPT Integration: Intelligent conversations with AI
  • Character AI: Role-play with different characters
  • Image Generation: Create AI-generated images

๐Ÿ›ก๏ธ Security Features

  • 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

๐Ÿ“Š Analytics & Monitoring

  • 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

๐Ÿ”„ Automation

  • 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

๐Ÿš€ Deployment Options

๐Ÿ“„ License

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

๏ฟฝ License Requirements

  • โœ… 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

โš ๏ธ Important Disclaimer

๐Ÿšจ Legal Notice

  • 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

๏ฟฝ๏ธ Safety Guidelines

  • 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

๐Ÿ“ž Support & Contact


๐ŸŽ‰ Thank you for using Knight Bot!

Made with โค๏ธ by the Knight Bot Team

GitHub Original

Star โญ this repository if it helped you!

About

A simple WhatsApp bot to manage groups, fetch data and having fun on your groups.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors