✨ 🧠 AMAZING BOT 🧠 ✨

💫 The Ultimate WhatsApp Automation Revolution 💫

🎯 Built with ❤️ by Ilom | Powered by NexusCoders

🚀 A next-generation WhatsApp bot featuring cutting-edge AI integration, stunning canvas graphics, advanced economy system, comprehensive admin tools, and enterprise-grade security. Experience automation like never before!

🚀 Quick Deploy • ✨ Features • 🔧 Installation • 📖 Commands • 🌐 API • 💬 Support

🌟 What's New in Latest Update

🎉 Major Enhancement Release! 🎉

✨ Latest Enhancements ✅ Beautiful Canvas Graphics - Stunning visual cards for all commands ✅ Advanced Help System - Interactive help with onReply support ✅ Epic Hangman Game - Canvas-based game with reply functionality ✅ Smart Admin Commands - Enhanced permission handling ✅ Anti-Link Protection - Comprehensive link detection & actions ✅ Auto-Reaction System - 20+ context-aware reactions ✅ Leveling System - XP progression with visual rewards ✅ Self-Listening Mode - Process own messages when needed ✅ Security Hardened - Enterprise-grade protection ✅ Multi-Platform Deploy - One-click deployment options

🔥 Key Highlights ⚡ Sub-100ms Response Time 🎨 Canvas Graphics - Professional visual cards 🛡️ Enterprise-Grade Security 🤖 Multi-AI Integration (GPT, Gemini) 💾 Optional Database - Works without it! 🌐 10+ Languages Supported 📊 Real-time Analytics Dashboard 🎮 Interactive Games - Reply-based gameplay 💬 Reply Handlers - Smart message interactions 🔘 Interactive Buttons - Quick command access

🚀 Experience the Future of WhatsApp Automation! 🚀

---

🚀 Quick Deploy

⚡ One-Click Deployment

🚀 Recommended 24/7 Uptime

⚡ Fast Auto Deploy

🎯 Reliable Free Tier

💪 Classic Enterprise

🔧 Dev Mode Instant Test

📋 System Requirements

Component	Requirement	Status
Node.js	20.0 or higher	✅ Required
MongoDB	4.4 or higher	🟡 Optional
WhatsApp Account	Any	✅ Required
Memory	512MB+	✅ Recommended
Storage	1GB+	✅ Recommended
Processor	1 vCPU+	✅ Recommended
Internet	Stable Connection	✅ Required

🎯 Platform-Specific Deployment

🚀 Koyeb Deployment (Recommended)

Step-by-Step Guide

1️⃣ Fork this repository to your GitHub account

2️⃣ Create Koyeb account at koyeb.com

3️⃣ Deploy from GitHub:

• Click "Create App"
• Select "GitHub" as source
• Choose your forked repository
• Koyeb will auto-detect settings from koyeb.yaml

4️⃣ Set Environment Variables:

SESSION_ID=your_session_id_here
OWNER_NUMBERS=your_phone_number
PREFIX=.
BOT_NAME=Amazing Bot

5️⃣ Optional - Add MongoDB:

MONGODB_URL=mongodb+srv://username:[email protected]/botdb

6️⃣ Deploy - Click "Deploy" and wait 2-3 minutes

✅ Done! Your bot is now live 24/7

Note: The bot works perfectly without MongoDB - it will use temporary data storage.

🚂 Railway Deployment

Quick Setup

1️⃣ Deploy to Railway:

• Click the Railway badge above
• Connect your GitHub account
• Select this repository

2️⃣ Environment Variables:

• Railway will use settings from railway.toml
• Add required variables in Railway dashboard:

SESSION_ID=your_session_id
OWNER_NUMBERS=your_number

3️⃣ Database (Optional):

• Railway offers free PostgreSQL/MongoDB
• Add database plugin from Railway dashboard
• Connection URL is auto-injected

4️⃣ Deploy:

• Railway auto-deploys on git push
• Check deployment logs for QR code

✅ Production Ready!

🎨 Render Deployment

Setup Process

1️⃣ Create Render Account at render.com

2️⃣ New Web Service:

• Connect GitHub repository
• Render auto-detects from render.yaml
• Set environment variables:

SESSION_ID=your_session_id
OWNER_NUMBERS=your_phone_number

3️⃣ Free MongoDB (Optional):

• Use MongoDB Atlas free tier
• Or Render's managed database

4️⃣ Deploy:

• Click "Create Web Service"
• Wait for build to complete

✅ Live in minutes!

🟣 Heroku Deployment

Heroku Setup

1️⃣ Prerequisites:

• Heroku CLI installed
• Git initialized in project

2️⃣ Deploy Commands:

heroku login
heroku create amazing-bot-app
git push heroku main

3️⃣ Set Config Vars:

heroku config:set SESSION_ID="your_session_id"
heroku config:set OWNER_NUMBERS="your_number"
heroku config:set PREFIX="."

4️⃣ Optional MongoDB:

heroku addons:create mongolab:sandbox

5️⃣ Check Logs:

heroku logs --tail

✅ Deployed!

💻 Replit Deployment (Development)

Replit Setup

1️⃣ Import to Replit:

• Click "Import from GitHub"
• Paste repository URL
• Replit auto-configures from replit.md

2️⃣ Environment Secrets:

• Click "Secrets" in sidebar
• Add:

SESSION_ID = your_session_id
OWNER_NUMBERS = your_number

3️⃣ Run:

• Click "Run" button
• Bot starts automatically
• Scan QR if no SESSION_ID set

✅ Perfect for testing!

Note: Replit works great without database - data is temporary until you add MongoDB URL.

🔧 Local Installation

Prerequisites

Requirement	Status	Download
Node.js 20+	✅ Required	Download
Git	✅ Required	Download
FFmpeg	🟡 Optional	Download
MongoDB	🟡 Optional	MongoDB Atlas

Windows Users: For shell scripts (backup, update, etc.), use Git Bash or WSL. Alternatively, run commands manually from the scripts.

Option 1: Automated Setup (Recommended)

git clone https://github.com/NexusCoders-cyber/Amazing-Bot-.git
cd Amazing-Bot-

npm run setup

This will:

• ✅ Check Node.js version
• ✅ Install all dependencies
• ✅ Create directory structure
• ✅ Generate .env from template
• ✅ Verify required binaries

Option 2: Manual Setup

git clone https://github.com/NexusCoders-cyber/Amazing-Bot-.git
cd Amazing-Bot-

npm install

cp .env.example .env
nano .env

npm start

⚙️ Configuration

🔑 Essential Variables

Create .env file with these required settings:

SESSION_ID=Ilom~base64_encoded_session_here
OWNER_NUMBERS=1234567890,9876543210
PREFIX=.
BOT_NAME=Amazing Bot

MONGODB_URL=mongodb+srv://user:[email protected]/botdb
DATABASE_ENABLED=true

OPENAI_API_KEY=sk-your-openai-api-key-here
GEMINI_API_KEY=your-google-gemini-api-key
OPENAI_MODEL=gpt-3.5-turbo

ENCRYPTION_KEY=your-secure-encryption-key-min-32-chars
JWT_SECRET=your-jwt-secret-key-here
SESSION_SECRET=your-session-secret-here

PUBLIC_MODE=true
SELF_MODE=false
AUTO_READ=false
AUTO_TYPING=true
MARK_ONLINE=true

MAX_CONCURRENT_COMMANDS=50
COMMAND_COOLDOWN=3
RATE_LIMIT_REQUESTS=20
CACHE_SIZE=1000

📱 Getting SESSION_ID

Method 1: QR Code (Easiest)

npm start

Method 2: From Running Bot

🗄️ Database Setup

Without Database (Quick Start)

MONGODB_URL=mongodb://localhost:27017/ilombot

With MongoDB (Production)

Option 1: MongoDB Atlas (Free)

MONGODB_URL=mongodb+srv://username:[email protected]/botdb

Option 2: Local MongoDB

MONGODB_URL=mongodb://localhost:27017/ilombot

Option 3: Platform Managed

• Railway, Render, Heroku offer managed databases
• Auto-inject connection strings

✨ Features

🎯 Core Capabilities

Category	Features	Count
🤖 AI & Chat	OpenAI GPT, Gemini, Smart Responses	15+
🎮 Games	8-ball, Trivia, Blackjack, Hangman	12+
💰 Economy	Currency, Daily Rewards, Gambling, Shop	18+
👑 Admin	Group Management, Moderation, Bans	20+
📥 Downloaders	YouTube, Instagram, TikTok, Facebook	10+
🔧 Utilities	QR, Encryption, Translate, Weather	15+
🎨 Media	Stickers, Filters, Compress, Convert	12+
🌐 Info	News, Search, Dictionary, Time	10+
👤 Owner	System Control, Backup, Execute Code	9+

Total: 142+ Commands loaded and tested!

🚀 Advanced Capabilities

🔐 Security Multi-level permissions Rate limiting Input validation Session encryption JWT authentication Credential sanitization

⚡ Performance Sub-100ms responses Efficient caching Database pooling Async processing Memory optimization Queue management

🌐 Platform Support Universal compatibility Cloud-native design Auto-scaling ready Zero-downtime updates Health monitoring Multi-platform deploy

💡 Smart Features

🔄 Auto-Recovery - Reconnects automatically 📊 Real-time Stats - Live monitoring 🌍 Multi-Language - 10+ languages 🎨 Canvas Graphics - Professional cards 💾 Smart Storage - Works with/without DB

🔔 Notifications - Owner alerts 📈 Analytics - Usage tracking 🛡️ Anti-Spam - Smart detection ⚡ Auto-Reaction - Context-aware 🎯 Leveling System - XP progression

📖 Command Guide

✨ Enhanced Help Command

The bot features a stylish, user-personalized help menu with:

🎯 User Info Display Shows name, ID, status, credits	⚡ Real-time Stats Current date, time, bot status	📱 Interactive Buttons Quick access to features
💬 Reply Support Detailed command assistance	🎨 Beautiful Formatting Clean, organized categories	🌐 Global Images Enhanced visual appeal

🎯 Essential Commands

.help              .menu              .ping              
.info              .status            .support           

👑 Admin Commands

Group Management

.kick @user          .ban @user         .unban @user       
.promote @user       .demote @user      .mute @user        
.unmute @user        .warn @user        .unwarn @user      
.tagall [msg]        .hidetag [msg]     .setdesc <text>    
.setname <text>      .groupinfo         .antilink on/off   
.delete              

🧠 AI Integration

AI Commands

.ai <message>        .chatgpt <msg>     .gemini <msg>      
.analyze <text>      .translate <txt>   .imagine <prompt>  
.stt [audio]         .tts <text>        .ocr [image]       

💰 Economy System

Money & Shop

.balance             .daily             .weekly            
.work                .gamble <amt>      .rob @user         
.transfer @user $    .shop              .buy <item>        
.inventory           .sell <item>       .leaderboard       

🎮 Games & Fun

Entertainment

.8ball <question>    .dice [sides]      .coin              
.rps <choice>        .joke              .quote             
.trivia              .blackjack         .tictactoe         
.hangman             .math              .word              
.memory              

📥 Downloaders

Social Media Downloads

.ytdl <url>          .ytmp3 <url>       .ytmp4 <url>       
.igdl <url>          .fbdl <url>        .tikdl <url>       
.twdl <url>          .pinterest <url>   .mediafire <url>   
.gdrive <url>        

🎨 Media Processing

Image & Video Tools

.sticker             .filter <type>     .blur              
.compress            .resize <width>    .crop              
.watermark           .meme <text>       .toaudio           
.toimg               .tovideo           .gif               

🔧 Utilities

Useful Tools

.qr <text>           .encrypt <text>    .decrypt <text>    
.hash <text>         .base64 <text>     .short <url>       
.weather <city>      .news              .search <query>    
.time                .uptime            .profile [@user]   

🔒 Owner Commands

System Management

.restart             .shutdown          .update            
.backup              .restore           .eval <code>       
.exec <command>      .setprefix <pfx>   .setstatus <txt>   
.setpp [image]       .broadcast <msg>   .join <link>       
.leave               .addpremium @user  .removepremium     
.gban @user          .gunban @user      

🎨 Canvas-Based Group Events

Professional Visual Notifications

👋 Welcome Messages Beautiful gradient cards with user avatars

👋 Goodbye Messages Stylish farewell cards with user info

👑 Promotion/Demotion Celebration-themed notification cards

📝 Group Updates Name & description change notifications

Advanced Systems

🎯 Level-Up System XP-based progression Beautiful achievement cards

⚡ Auto-Reactions 20+ context-aware emojis Smart sentiment analysis

🎨 Custom Graphics Professional design Fully customizable

🌐 API Reference

Base URL

http://localhost:5000/api

📊 Available Endpoints

Endpoint	Method	Description
/api/health	GET	Health check
/api/stats	GET	System statistics
/api/commands	GET	List all commands
/api/users	GET	User management
/api/groups	GET	Group management
/api/qr	GET	QR code for pairing
/api/messages	POST	Send messages
/api/analytics	GET	Usage analytics

📊 Health Check Response

{
  "status": "healthy",
  "timestamp": "2025-11-02T00:00:00.000Z",
  "uptime": "5h 23m 15s",
  "memory": {
    "used": "45.2 MB",
    "total": "512 MB"
  },
  "whatsapp": {
    "connected": true,
    "qr_scanned": true
  },
  "database": {
    "connected": true,
    "type": "mongodb"
  }
}

🔧 Troubleshooting

❌ MongoDB Connection Timeout

Problem: Operation users.findOne() buffering timed out after 10000ms

✅ Solution: This is now automatically handled! The bot will:

• Use real database if connected
• Use temporary data if database unavailable
• No timeout errors sent to your WhatsApp

For production:

MONGODB_URL=mongodb+srv://username:[email protected]/botdb

For testing without database:

MONGODB_URL=mongodb://localhost:27017/ilombot

❌ Canvas/Graphics Not Working

Problem: Canvas images not generating for group events

✅ Solution: Ensure canvas dependencies are installed:

sudo apt-get install build-essential libcairo2-dev libpango1.0-dev libjpeg-dev libgif-dev librsvg2-dev

brew install pkg-config cairo pango libpng jpeg giflib librsvg

npm install canvas --build-from-source

❌ Commands Not Working

Problem: Bot doesn't respond to commands

✅ Solution:

1. Check prefix is correct in .env file
2. Verify bot is running: npm start
3. Check logs for errors: tail -f logs/bot.log 4.Ensure you have permission to use the command
4. Test with basic command: .ping
5. Verify WhatsApp connection is active
6. Check if command is loaded: .help

❌ Session Expired/Invalid

Problem: Bot keeps disconnecting or shows "Session Invalid"

✅ Solution:

1. Delete existing session files
2. Clear cache/auth_info_baileys/ folder
3. Remove SESSION_ID from .env
4. Restart bot and scan new QR code
5. Save new SESSION_ID for future use

rm -rf cache/auth_info_baileys/
npm start

❌ High Memory Usage

Problem: Bot consuming too much memory

✅ Solution:

1. Reduce CACHE_SIZE in .env
2. Clear temporary files: npm run cleanup
3. Restart bot periodically
4. Optimize database queries
5. Monitor with: npm run logs

CACHE_SIZE=500
MAX_CONCURRENT_COMMANDS=25

🛠️ Utility Scripts & Maintenance

Comprehensive Management Tools

📦 Installation npm run setup Automated installation	🧹 Maintenance npm run cleanup Clean temporary files	💾 Backup npm run backup Create full backup
🔄 Update npm run update Smart update system	📊 Database npm run migrate Run migrations	🔍 Logs npm run logs View PM2 logs

Script Details

Script	Purpose	Safe Mode
cleanup.js	Removes temp files, preserves session	✅ Yes
backup.sh	Backs up session, media, database	✅ Yes
restore.sh	Restores from backup with confirmation	⚠️ Overwrites
migrate.js	Database schema migrations	✅ With rollback
seed.js	Populate DB with demo data	✅ Idempotent
update.js	Smart update with environment detection	✅ Platform-aware
update.sh	Shell-based git pull + dependencies	⚠️ Stashes changes

🔐 Session Management

Multiple Session Format Support

Ilom Format Default

Base64 JSON Encoded

Direct JSON Raw

Mega.nz Cloud Cloud Storage

Multi-File Baileys

Supported Formats

1. Ilom Format (Default)

SESSION_ID=Ilom~eyJub2lzZUtleS...

2. Base64 JSON

SESSION_ID=eyJjcmVkcyI6eyJub...

3. Direct JSON

SESSION_ID={"creds":{"noiseKey":...}}

4. Mega.nz Cloud

SESSION_ID=sypher™--MEGA_FILE_ID

5. Multi-File Baileys (Auto-generated)

• Location: cache/auth_info_baileys/
• Contains: creds.json + keys/*.json

Getting Your Session

Method 1: QR Code Leave SESSION_ID empty Run npm start Scan QR with WhatsApp Session auto-saved

Method 2: Pairing Code QR_SCANNER_ENABLED=true npm start

Method 3: Existing Session Paste SESSION_ID in .env Bot auto-detects format Converts automatically

📚 Documentation

Comprehensive Guides & Resources

📖 Installation Complete setup guide	⚙️ Configuration Environment setup	🚀 Deployment Production guide	📝 Commands Full reference
🔌 Plugins Development guide	🐛 Troubleshooting Common issues	🔐 Security Security policy	🤝 Contributing Contribution guide

💬 Support & Community

🌟 Join Our Thriving Community! 🌟

💬 WhatsApp Group Chat & Support

📢 Telegram Channel Updates & News

🎮 Discord Server Community Hub

🐛 Report Bugs Issue Tracker

💡 Get Help Instantly

📚 Documentation Complete guides and tutorials Read Docs

❓ FAQ Common questions answered View FAQ

🎯 Examples Sample code & tutorials Browse Examples

👨‍💻 Author & Credits

🌟 Created by Ilom 🌟

Ilom Lead Developer & Creator

🏢 Powered by NexusCoders

Building next-generation automation solutions for everyone

🙏 Acknowledgments

🔧 Core Technologies 🎯 Baileys - WhatsApp API 🤖 OpenAI - GPT Integration 🧠 Google Gemini - AI Capabilities 🖼️ Canvas - Graphics 📦 Node.js - Runtime 💾 MongoDB - Database

🌟 Special Mentions 💖 All Contributors 🐛 Bug Reporters 📝 Documentation Writers 🎨 Designers 🌍 Community ⭐ Stargazers

📊 Project Statistics

🏆 Achievements & Milestones

GitHub Stars

Repository Forks

Active Users

Messages Processed

🤝 Contributing

We welcome contributions from the community!

How to Contribute

1️⃣ Fork Fork the repository

2️⃣ Branch Create feature branch

3️⃣ Commit Make your changes

4️⃣ PR Open pull request

Contribution Guidelines

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

See CONTRIBUTING.md for detailed guidelines.

📄 License

This project is licensed under the MIT License

See the LICENSE file for details

MIT License Summary

✅ Commercial Use Use for business	✅ Modification Modify the code	✅ Distribution Share with others
✅ Private Use Use privately	⚠️ Liability No warranty	⚠️ Trademark No trademark rights

🔒 Security

Security is Our Priority

Found a security issue? Please report it responsibly!

🔐 Report Security Issues View Security Policy

📧 Contact Security Team [email protected]

Security Features

• 🔐 End-to-end encryption
• 🛡️ Rate limiting & DDoS protection
• 🔒 Secure session management
• ✅ Input validation & sanitization
• 🚫 Anti-spam & abuse prevention
• 🔑 JWT authentication

⚙️ Changelog

📜 View Full Changelog

Version 1.0.0 (Current)

🎉 Initial Release

• ✨ 142+ commands across 9 categories
• 🎨 Beautiful canvas graphics
• 🤖 Multi-AI integration (GPT, Gemini)
• 💰 Complete economy system
• 👑 Advanced admin tools
• 🎮 Interactive games
• 📥 Social media downloaders
• 🔧 Comprehensive utilities
• 🛡️ Enterprise-grade security
• 🌐 Multi-platform deployment

🎉 Thank You

🌟 Thank You for Using Amazing Bot! 🌟

⭐ If you find this project helpful, please give it a star! ⭐

💝 Made with Love by Ilom & NexusCoders Team 💝

Crafted with precision, passion, and lots of ☕

© 2024-2025 Amazing Bot. All Rights Reserved.