A powerful, feature-rich WhatsApp bot with 90+ commands, AI integration, media tools, group management, and themed responses — built on Node.js and the Baileys library.

---

⚡ Deploy Silva MD Bot

Before you deploy — get your Session ID first

  

Choose your hosting platform

🟣 Heroku Best for 24/7 uptime ⭐ Recommended	🚂 Railway $5 free credits/month No sleep on free tier	🟡 Koyeb Zero cold-starts Always-on free tier
🟠 Replit Browser-based IDE Edit code live	🔵 Talkdrove No coding needed One-click deploy	💻 Local / VPS Full control Custom plugins

📖 Click the platform name below to see step-by-step instructions

---

 Heroku  —  Recommended · 24/7 uptime · Auto-restart on crash

 

Requirements: Heroku account (free) · GitHub account

Step	Action
1	Fork the repo to your GitHub account
2	Open silva-md-fork-checker.vercel.app and click Deploy to Heroku
3	Fill in SESSION_ID, OWNER_NUMBER, BOT_NAME on the Heroku setup screen
4	Click Deploy App — wait ~2 minutes
5	Go to More → View Logs and confirm you see ✅ Connected to WhatsApp

💡 RUNS 24/7 COSTS $ 1: .

---

 Railway  —  $5 free credits/month · No sleep · Fast build

 

Step	Action
1	Fork the repo to your GitHub account
2	Go to railway.app → New Project → Deploy from GitHub
3	Select your forked silva-md-bot repo
4	Open the Variables tab and add the keys below
5	Railway auto-detects Node.js — watch the build logs
6	Look for ✅ Connected to WhatsApp in the deploy logs

Required variables:

Variable	Value
SESSION_ID	Your session ID from the generator
OWNER_NUMBER	Your number e.g. 254712345678
BOT_NAME	Your bot's display name
PREFIX	. (default)

---

 Koyeb  —  Always-on free tier · Zero cold-starts · Global edge

 

Step	Action
1	Fork the repo to your GitHub account
2	Go to app.koyeb.com → Create App → GitHub
3	Select your fork · Set Run command to node silva.js
4	Add SESSION_ID, OWNER_NUMBER, BOT_NAME under Environment Variables
5	Pick the region closest to you → click Deploy (~3 min)
6	Check the Logs tab for the connected confirmation

---

 Replit  —  Browser IDE · Edit code live · Deployments for 24/7

Step	Action
1	Open or fork this project in Replit
2	Go to Tools → Secrets (the lock icon in the sidebar)
3	Add SESSION_ID, OWNER_NUMBER, BOT_NAME as secrets
4	Hit the Run button — node silva.js starts automatically
5	Watch the Console for ✅ Connected to WhatsApp
6	For 24/7 uptime, enable Replit Deployments → Always On

---

 Talkdrove  —  No coding needed · One-click · Beginner friendly

Step	Action
1	Click the button above to open the Silva MD bot page on Talkdrove
2	Click Host This Bot
3	Enter your SESSION_ID and OWNER_NUMBER
4	Click Deploy — your bot goes live instantly ✅

No GitHub account or terminal required. Perfect for first-time bot owners.

---

 Local / Self-Hosted  —  Full control · Custom plugins · Developer mode

Requirements: Node.js 18+  ·  Git  ·  FFmpeg (optional — needed for media conversion)

# Clone the repository
git clone https://github.com/SilvaTechB/silva-md-bot.git
cd silva-md-bot

# Install dependencies
npm install

# Add your config
cp config.env.example config.env
# Open config.env and fill in SESSION_ID, OWNER_NUMBER, etc.

# Start the bot
node silva.js

Keep it running 24/7 with PM2:

npm install -g pm2
pm2 start silva.js --name silva-md
pm2 save && pm2 startup

Update to the latest version:

git pull && npm install && pm2 restart silva-md

---

🔑 How to Get a Session ID

You need a Session ID so the bot can connect to your WhatsApp account without scanning a QR code every time.

📱 Session ID setup guide

1. Open the session generator:
2. Choose QR Code or Pairing Code method
3. Scan with WhatsApp → Settings → Linked Devices → Link a Device
4. Copy the SESSION_ID value shown on screen
5. Paste it into your platform's environment/secret variables as SESSION_ID

⚠️ Keep your Session ID private. It gives full access to your WhatsApp account. Never share it publicly.

Session rules (important for stability):

• On restart, only creds.json is replaced from the session — never delete pre-key-*.json or session-*.json files manually, this causes auth failures
• If the bot stops responding after a restart, regenerate your session ID from the generator above

---

✨ Features

📥 Media & Downloads

Command	Description
.play / .music	Download YouTube audio
.yt / .youtube	Download YouTube video
.tiktok / .tt	Download TikTok videos
.instagram / .ig	Download Instagram reels & posts
.facebook / .fb	Download Facebook videos
.lyrics	Fetch song lyrics
.apk	Download APK from Play Store
.shorten	Shorten any URL
.tourl / .imgurl	Upload media and get a link
.gitclone	Clone a GitHub repo as a zip

🤖 AI & Smart Tools

Command	Description
.ai / .gpt	Chat with an AI assistant
.tts / .speak	Text-to-speech (19+ languages)
.translate / .tr	Translate text to any language
.define / .dict	Dictionary definition
.weather	Real-time weather lookup
.wiki / .wikipedia	Wikipedia search
.qr / .qrcode	Generate a QR code from any text
.calc / .math	Calculator
.base64 / .b64	Encode / decode base64
.morse	Morse code encoder/decoder
.ip	IP address lookup
.virus / .scanurl	Scan a URL for malware

👥 Group Management

Command	Description
.kick / .remove	Remove a member
.promote / .demote	Change admin status
.warn	Issue a warning (auto-kick at 3)
.warnlist	View all active warnings
.tagall / .mentionall	Mention all members
.hidetag	Silent tag (notify without showing)
.lock / .unlock	Toggle send-message restriction
.antilink on/off	Block links from non-admins
.welcome / .goodbye	Auto-messages when members join/leave
.setname / .setdesc	Change group name or description
.grouplink / .revoke	Get or revoke group invite link
.poll / .vote	Create a native WhatsApp poll
.antigm	Block @everyone mass-mentions

🛡️ Protection Suite

Feature	Command	What it does
Anti-Delete	.antidelete on/off	Recovers deleted messages, forwards to owner with full media
Anti-Link	.antilink on/off	Removes links posted by non-admins in groups
Anti-Call	.anticall	Auto-rejects incoming calls (owner exempt)
Anti-Fake	.antifake	Blocks users with unrecognized country codes
Anti-@Everyone	.antigm	Deletes/warns/kicks users who mass-mention
Anti-Demote	.antidemote	Auto-restores demoted admins
Anti-ViewOnce	ANTIVV=true	Automatically forwards view-once media to you
Auto Status View	AUTO_STATUS_SEEN=true	Silently views all contact statuses
Auto Status React	AUTO_STATUS_REACT=true	Reacts to statuses with random emojis

🎮 Fun & Games

Command	Description
.joke / .jokes	Random joke
.quote / .inspire	Inspirational quote
.fact / .funfact	Random interesting fact
.riddle	Random riddle
.flip / .coin	Flip a coin
.dice / .roll	Roll a dice
.compliment	Random compliment
.bible / .verse	Random Bible verse
.numberfact	Fact about any number
.ascii / .art	Text art generator
.sticker / .s	Create sticker from image or video

👑 Owner Tools

Command	Description
.ban / .unban	Ban users from using bot commands
.broadcast / .bc	Send a message to all chats
.eval / .exec	Run JavaScript code live
.settings / .config	View all bot settings
.theme / .settheme	Change bot theme/character voice
.setgreet	Set auto-greeting for DMs
.greeton / .greetoff	Toggle daily auto-greeting
.warn	Warn group members
.promote / .demote	Manage group admins
.owner / .creator	Show owner contact info

---

⚙️ Environment Variables

View all variables

Variable	Description	Default
SESSION_ID	WhatsApp session credentials	required
PREFIX	Command prefix character	.
BOT_NAME	Display name for the bot	Silva MD
OWNER_NUMBER	Your WhatsApp number with country code	required
OWNER_NAME	Your name shown in bot info	Silva MD
DESCRIPTION	Caption for the bot menu	Silva MD Bot
THEME	Bot theme — silva, naruto, gojo, batman, more	silva
MODE	Who can use the bot: public, private, group, inbox	public
GREETING	Auto-greeting for DMs (sent once per day)	(blank = off)
AUTO_STATUS_SEEN	Auto-view all statuses	true
AUTO_STATUS_REACT	Auto-react to statuses	true
AUTO_STATUS_REPLY	Auto-reply to statuses	false
AUTO_STATUS_MSG	Message used for auto status reply	Seen by Silva MD
AUTO_REACT_NEWSLETTER	React to newsletter/channel messages	true
CUSTOM_REACT_EMOJIS	Comma-separated emojis for status reactions	❤️,🔥,💯,😍,👏
ANTIDELETE_GROUP	Restore deleted messages in groups	true
ANTIDELETE_PRIVATE	Restore deleted messages in private	true
ANTILINK	Block links globally in all groups	false
ANTIVV	Auto-open view-once messages	true
ALWAYS_ONLINE	Show bot as always online	false
AUTO_TYPING	Show typing indicator while processing	true
AUTO_RECORDING	Show recording indicator for media commands	false
READ_MESSAGE	Auto blue-tick all messages	false
ALIVE_IMG	Image URL shown in .alive command	(default)
LIVE_MSG	Message shown in .alive command	Silva MD is active
DEBUG	Enable verbose logging	false

---

🎨 Themes

Available themes — change with .settheme <name>

Each theme gives the bot a different personality, name, and response style.

Theme	Character	Style
silva	Silva MD	Default — clean and professional
naruto	Naruto Uzumaki	Energetic, ninja spirit
gojo	Satoru Gojo	Confident, Jujutsu Kaisen
itachi	Itachi Uchiha	Calm, powerful
goku	Son Goku	Friendly, Dragon Ball
luffy	Monkey D. Luffy	Carefree, One Piece
zerotwo	Zero Two	Playful, Darling in the FranXX
nezuko	Nezuko Kamado	Gentle, Demon Slayer
batman	Batman	Dark, serious
thanos	Thanos	Philosophical, powerful
friday	FRIDAY	AI assistant style
edith	EDITH	Tech-forward
gideon	Gideon	Arrow-verse AI
adam	Adam	Minimal, elegant
ayanokoji	Ayanokoji	Cold, calculated
genos	Genos	One Punch Man
parker	Peter Parker	Friendly neighborhood style
suhail	Suhail	Custom

Set via command: .settheme gojo Set via config: THEME=gojo in your secrets/env file

---

🏗️ Project Structure

Expand file layout

silva-md-bot/
├── silva.js            # WhatsApp connection, auto-status, event loop
├── handler.js          # Message routing, permissions, plugin dispatch
├── config.js           # All environment variables in one place
├── app.json            # Heroku deploy config + variable definitions
│
├── plugins/            # 90 command plugins (one file per feature)
│   ├── menu.js         # Help menu
│   ├── settings.js     # Bot settings panel
│   ├── greet.js        # Daily auto-greeting (on/off, once per day)
│   ├── warn.js         # Warning system (auto-kick at 3)
│   ├── antigm.js       # Anti-@everyone mass-mention
│   ├── antifake.js     # Block unrecognized country codes
│   ├── sticker.js      # Sticker creator
│   ├── silva-ai.js     # AI chat
│   ├── music.js        # YouTube audio
│   ├── tiktok.js       # TikTok downloader
│   ├── welcome.js      # Welcome / goodbye system
│   ├── warn.js         # Warning + auto-kick system
│   └── ...             # 78+ more plugins
│
├── lib/
│   ├── theme.js        # Theme engine + fmt() helper
│   └── ...
│
├── themes/             # Theme JSON files (silva, naruto, gojo, etc.)
│   └── silva.json
│
├── data/               # Runtime JSON storage (warns, greet, etc.)
│   ├── warns.json
│   └── greet.json
│
└── package.json

---

📋 Full Command List

All 90 commands by category

Category	Commands
Media	.play .music .yt .youtube .tiktok .tt .instagram .ig .facebook .fb .lyrics .apk .shorten .tourl .imgurl .gitclone
AI & Tools	.ai .gpt .tts .speak .translate .tr .define .dict .weather .wiki .qr .qrcode .calc .math .base64 .b64 .morse .ip .virus .scanurl .shazam .ascii
Stickers	.sticker .s .toaudio .tomp3
Group Management	.kick .remove .promote .demote .admin .unadmin .warn .unwarn .warnlist .tagall .mentionall .hidetag .silenttag .lock .unlock .antilink .welcome .goodbye .setname .setdesc .grouplink .revoke .poll .vote .antigm
Protection	.antidelete .anticall .antifake .antidemote .antivv .antilink
Fun	.joke .quote .inspire .fact .funfact .riddle .flip .coin .dice .roll .compliment .bible .verse .numberfact
Owner	.ban .unban .banlist .broadcast .bc .eval .exec .settings .config .theme .settheme .setgreet .getgreet .delgreet .greeton .greetoff .owner .creator
Utility	.menu .help .ping .alive .bot .botinfo .uptime .runtime .getjid .jid .profile .spp .getpp .remind .remindme .presence .typing .online .offline .react .afk .back .time .clock .currency .convert .country .ip .password .tempmail .viewonce .vv

---

🔧 Built With

---

🤝 Connect With Silva

---

👨‍💻 Contributors

Silva	CEO
Creator & Lead Dev	Contributor

---

🌍 Community

---

📄 License

MIT License — free to use, modify, and distribute with attribution.

Built with purpose by Silva Tech Inc

_{Silva MD Bot — 90 commands. One scan. Unlimited possibilities.}