⚡ XYLO-MD ⚡

The Next-Generation WhatsApp Multi-Device Bot

349+ Commands | 28 Categories | Built with TypeScript

---

🌟 Why XYLO-MD?

XYLO-MD isn't just another WhatsApp bot — it's a full-featured ecosystem built on the Baileys library with modern AI, a deep economy system, group security, and more. Designed for speed, stability, and style.

🤖 AI Powered LLaMA 3.3, GPT, Groq & Pollinations for smart conversations, web search, and image generation	🛡️ Group Security Anti-link, anti-spam, anti-raid, anti-delete, warnings system & full moderation suite	⚡ High Performance Smart caching, debounced writes, TTL-based group metadata & minimal downtime
🎮 Economy & Games Full RPG economy with 60+ commands, 13-level perks, gambling, fishing, hunting & more	📥 Media Suite Download from YouTube, TikTok, Instagram, Snapchat, Pinterest & more instantly	🎭 Unique Features Anonymous confessions, native polls, audio editing, sticker creation & custom commands

---

📊 Command Categories

Category	Commands	Highlights
💰 Economy	60+	Coins, banking, shop, gambling, fishing, hunting, robbing, level perks
🛡️ Group	56+	Moderation, anti-link, anti-raid, welcome cards, warnings, mute/kick/ban
🔧 Owner	25+	Bot management, broadcast, block/unblock, eval, shell, settings
🛠️ Tools	22+	Calculator, translate, weather, QR code, URL shortener, base64
🎉 Fun	20+	Ship, roast, compliment, 8ball, truth/dare, memes, confessions
📥 Download	15+	YouTube, TikTok, Instagram, Snapchat, Facebook, Pinterest, Spotify
🔍 Search	13+	Google, Wikipedia, GitHub, Lyrics, PlayStore, weather
🎮 Games	13+	Trivia, hangman, tic-tac-toe, word chain, math challenge, riddles
📱 WhatsApp	12+	Presence, profile edits, privacy settings, group management
🤖 AI	12+	Chat, image gen, vision, web search, AI tools, chatbot toggle
✏️ Creator	11+	Sticker packs, custom commands, canvas tools, logos
🔮 Misc	9+	Fake ID, religion, AFK, reminders, schedule, analytics
🎵 Media	6+	Audio effects, image editing, video conversion, sticker tools
🖼️ Anime	5+	Anime search, waifu, character lookup, neko, wallpapers
ℹ️ Info	5+	Bot stats, ping, runtime, system info, speed test

---

🏆 Standout Features

🎭 Anonymous Confessions

Send anonymous messages to any group — no prefix needed in DMs!

• Groups get a short code (e.g., gr1, gr2) when confessions are enabled
• Users DM the bot: confess gr1 I have a secret to share
• Message appears anonymously in the group
• Rate limited: 5 min cooldown, 10/day max
• Admin toggle per group: .confession on/off
• Lists available groups with names when you just type confess

💰 Economy & Level Perks

A deep virtual economy with 60+ commands:

• Earning: Daily rewards, work, crime, fishing, hunting, begging, robbing
• Banking: Deposit, withdraw, transfer, interest
• Shop & Assets: Buy items, buffs, collectibles
• Gambling: Coinflip, slots, blackjack, dice, roulette, crash
• Social: Marriage, leaderboards, achievements, profiles
• 13 Level Perks (Lv.5 to Lv.100):
  • Earning multipliers (1.1x to 2.0x)
  • Cooldown reductions (up to 35% off)
  • Special abilities: rob shield, crime boost, legendary title
  • All perks stack and apply automatically

🛡️ Group Moderation

Comprehensive group management and security:

• Anti-Link — Auto-delete links with warnings
• Anti-Spam — Detect and handle spam behavior
• Anti-Raid — Automatic protection against mass joins
• Anti-Bad-Words — Customizable word filter
• Anti-Sticker — Block sticker flooding
• Anti-Delete — Forward deleted messages to admins
• Warning System — Configurable thresholds with auto-actions
• Welcome/Goodbye — Canvas-generated cards with custom messages
• Slowmode — Queue commands with delays to avoid rate limits

🤖 AI Integration

Multiple AI backends for smart conversations:

• Groq — LLaMA 3.3 70B with web search augmentation
• OpenRouter — GPT model fallback
• Pollinations — Text generation for AI tools
• Image Generation — Flux, SeaArt, and more
• Vision — Analyze images sent to the bot
• Conversation Memory — Persistent chat history per user
• Web Search — DuckDuckGo-augmented AI responses

📥 Media Downloaders

Download content from popular platforms:

• YouTube (video + audio)
• TikTok (no watermark)
• Instagram (posts, reels, stories)
• Snapchat Spotlight
• Facebook videos
• Pinterest images
• Spotify tracks
• GitHub repositories

🎮 Interactive Games

Play games right in WhatsApp:

• Word Connection
• Trivia (multiple categories)
• Hangman
• Tic-Tac-Toe
• Math Challenge
• Emoji Quiz
• Riddles
• Party Games
• All integrated with the economy system for betting

---

🔑 Step 1: Get Your Session

You need a SESSION_ID to authenticate the bot with WhatsApp.

   

---

🚀 Step 2: Deploy

One-click deploy to your favorite cloud platform:

Platform	Status	Deploy
Heroku
Render
Railway
Replit
Koyeb

---

💻 Manual Installation

Click to expand

Prerequisites

• Node.js v18 or higher
• Git
• FFmpeg
• MongoDB (Atlas free tier works)

Setup

# Clone the repository
git clone https://github.com/DAV-EX/XYLO-MD.git

# Enter the directory
cd XYLO-MD

# Install dependencies
npm install

Configure

Create a .env file in the root directory:

SESSION_ID=YOUR_SESSION_ID_HERE
PREFIX=.
OWNER_NUMBER=YOUR_NUMBER
MODE=public
MONGO_URI=mongodb+srv://your-connection-string

Run

# Development
npm run dev

# Production (with PM2)
npm start

---

📂 Project Structure

XYLO-MD/
├── 📄 index.ts              # Main entry point — WhatsApp socket, events, routing
├── 📄 config.ts              # Configuration management with MongoDB sync
├── 📁 plugins/               # 62 command plugin files
│   ├── 📁 economy/           # Economy subsystem (core, shop, bank, assets, market, betting, admin)
│   ├── 📄 ai.ts              # AI chat commands
│   ├── 📄 confess.ts         # Anonymous confession system
│   ├── 📄 games.ts           # Interactive games
│   ├── 📄 group.ts           # Group moderation commands
│   ├── 📄 downloader.ts      # Media downloaders
│   └── ...                   # 50+ more plugin files
├── 📁 lib/                   # Core libraries
│   ├── 📄 economy.ts         # Economy engine, leveling, perks, achievements
│   ├── 📄 groupMeta.ts       # Group metadata caching
│   ├── 📄 antiRaid.ts        # Anti-raid protection
│   ├── 📄 welcomeHandler.ts  # Welcome/goodbye canvas cards
│   └── ...                   # Moderation, utilities, game logic
├── 📁 data/                  # Data utilities (audio editor, text styles)
├── 📁 store/                 # Runtime data storage
├── 📁 session/               # WhatsApp auth credentials
└── 📁 tmp/                   # Temporary media processing files

---

⚙️ Tech Stack

Technology	Purpose
TypeScript	Primary language with tsx for direct execution
Baileys	WhatsApp Web API (multi-device protocol)
MongoDB	Configuration persistence & economy data
Express	Keep-alive server for cloud hosting
PM2	Production process management
FFmpeg	Audio/video processing & conversion
Sharp	Image manipulation & optimization
Canvas	Welcome card generation
Groq / OpenRouter	AI chat backends
Node Cache	In-memory caching with TTL

---

🔒 Environment Variables

Variable	Required	Description
SESSION_ID	Yes	WhatsApp session authentication key
PREFIX	No	Command prefix (default: .)
OWNER_NUMBER	No	Bot owner's phone number
MODE	No	public or private (default: public)
MONGO_URI	No	MongoDB connection string
GROQ_API_KEY	No	Groq API key for AI features
OPENROUTER_API_KEY	No	OpenRouter API key for AI fallback

---

🤝 Contributing

Contributions are welcome! Feel free to:

1. Fork the repository
2. Create a 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

---

📜 License

This project is open source. Please give credit if you fork or modify it.

---

Created & Maintained by DavidXTech

If you found XYLO-MD useful, leave a star!

_{XYLO-MD v3.0.3 — Powered by DavidXTech}