SilvaTechB/silva-md-bot

---

📋 Contents

🔐 Get Session ID	✨ Features
🚀 Deploy	🎨 Themes
⚙️ Environment Variables	🤝 Connect

---

🔐 Step 1 — Get Session ID

⚡ You need a Session ID before deploying. It links the bot to your WhatsApp account.

1. Click the button above
2. Choose QR Code or Pairing Code
3. Link your WhatsApp
4. Copy the SESSION_ID shown
5. Paste it into your host's secrets panel

⚠️ Never share your Session ID. It grants full access to your WhatsApp account.

---

🚀 Step 2 — Deploy

💡 Silva Host is purpose-built for this bot. Fastest setup with zero configuration headaches.

Step	Action
1	Click Deploy Now → host.silvatech.co.ke
2	Log in or create a Silva Host account
3	Fill in SESSION_ID, OWNER_NUMBER, BOT_NAME
4	Click Deploy — bot goes live in seconds ✅

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

Step	Action
1	Fork the repo to your GitHub
2	Go to railway.app → New Project → Deploy from GitHub
3	Select your forked repo
4	Open Variables tab → add SESSION_ID, OWNER_NUMBER, BOT_NAME
5	Check logs for ✅ Connected to WhatsApp

Step	Action
1	Fork the repo to your GitHub
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	Click Deploy → check logs for ✅ Connected to WhatsApp

Step	Action
1	Open or fork this project in Replit
2	Go to Tools → Secrets
3	Add SESSION_ID, OWNER_NUMBER, BOT_NAME as secrets
4	Hit Run — look for ✅ Connected to WhatsApp in the console

Step	Action
1	Open host.talkdrove.com/share-bot/49
2	Click Host This Bot
3	Enter your SESSION_ID and OWNER_NUMBER
4	Click Deploy — bot goes live instantly ✅

Requirements: Node.js 20+ · Git

# Clone & Install
git clone https://github.com/SilvaTechB/silva-md-bot.git
cd silva-md-bot
npm install

# Configure
cp config.env.example config.env
# → Fill in SESSION_ID, OWNER_NUMBER, etc.

# Start
node silva.js

Keep running 24/7 with PM2:

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

---

⚙️ Environment Variables

Set these as secrets on your host, or in a local config.env file.

🔑 Essential

Variable	Default	Description
SESSION_ID	required	Your WhatsApp session (from session generator)
OWNER_NUMBER	auto	Your WhatsApp number with country code e.g. 254712345678
BOT_NAME	Silva MD	Bot display name
PREFIX	.	Command prefix (. , ! / or comma-separated)
MODE	public	public · private · group · inbox
THEME	silva	Bot personality — see Themes

🧠 Agent v2

Agent v2 is the primary Silva assistant backed by ch.at and does not require an API key. It can use approved tools for calculations, command discovery, bot status, persistent chat memory, web lookup, weather, and the universal public-media downloader. It runs through prefix-free Silva ... messages or .silva, .autopilot, .agent2, and .copilot. The previous implementation remains available only as .legacy-agent.

Variable	Default	Description
AGENT_API_KEY	empty	Optional key for structured tool-calling; ch.at is used when empty
AGENT_API_URL	OpenAI API	Optional provider base URL, including /v1 when required
AGENT_MODEL	gpt-4o-mini	Optional structured-provider model identifier
AGENT_MAX_STEPS	5	Maximum tool-calling steps per request, capped at 8

Example:

# Optional: leave these unset to use ch.at only.
AGENT_API_KEY=your_provider_key
AGENT_API_URL=https://api.openai.com/v1
AGENT_MODEL=gpt-4o-mini
AGENT_MAX_STEPS=5

Try it with .autopilot calculate 25 * 4, .autopilot weather in Nairobi, or .autopilot remember that I prefer short answers. Use .autopilot forget to clear the chat's persistent Agent v2 memory. Runtime memory is stored in data/agent-v2-memory.json, which is ignored by Git. The existing prefix-free Silva, ... assistant also uses ch.at as its no-key backend.

🎛️ Prefix control

The owner can change the command mode from a normal command or by speaking naturally to Silva. These changes apply immediately and are persisted in the local config.env file for the next restart:

.setprefix .
.setprefix none
Silva, set prefix to .
Silva, set prefix to null

Use null, none, off, or no prefix to enable prefix-free commands. Use a symbol such as ., !, or .,!,/ to require one or more prefixes. Prefix changes are owner-only.

🗄️ Encrypted Postgres storage

When DATABASE_URL is configured, Silva creates encrypted tables for users, selected Agent v2 conversations, and developer contacts. Agent chat content is encrypted with AES-256-GCM before it is stored, using the bot's existing session secret as the encryption source. The three built-in developer contacts are 254700143167, 254755257907, and 254743706010, and they are available through .developers.

Never commit the real Neon connection string. Add the single DATABASE_URL value to your hosting provider's private secret/environment-variable panel. The database is optional, and the bot continues running if Postgres is unavailable. Owner feature toggles set with commands such as .setautobio on, .setautoreact on, .setautoread on, and .setsetting KEY value are also written to the encrypted silva_user_settings table when Postgres is available.

📚 Command menu

.menu builds its category counts from the live plugin registry on every request. Curated commands keep their intended category, new commands are classified from their command name and description, and any unmatched command is placed in Advanced Utilities rather than being hidden. Each command is assigned to one category only. Use .menu <number> for a category listing, .allmenu <page> for the complete alphabetical directory, and .help <command> for usage details.

📸 Auto-Status

Variable	Default	Description
AUTO_STATUS_SEEN	true	Auto-view contacts' statuses
AUTO_STATUS_REACT	true	Auto-react to statuses
AUTO_STATUS_REPLY	false	Auto-reply to statuses

🛡️ Protection

Variable	Default	Description
ANTICALL	true	Auto-reject all incoming calls
ANTIDELETE_GROUP	true	Recover deleted group messages → forward to owner
ANTIDELETE_PRIVATE	true	Recover deleted private messages → forward to owner
ANTILINK	false	Block links from non-admins in groups
ANTIVV	true	Auto-reveal view-once media → forward to owner

⚡ Behavior

Variable	Default	Description
ALWAYS_ONLINE	true	Keep bot shown as always online
AUTO_TYPING	true	Show typing indicator while processing
AUTO_BIO	true	Update the bot About text when connecting
AUTO_REACT_MESSAGES	false	React to ordinary incoming messages with a 15-second per-chat cooldown
READ_MESSAGE	false	Auto blue-tick all messages
DEBUG	false	Verbose logging

---

✨ Features

🛡️ Protection Suite

Feature	Enable	What It Does
Anti-Call	ANTICALL=true or .anticall on	Rejects all calls, notifies owner
Anti-Delete	ANTIDELETE_GROUP/PRIVATE=true	Recovers & forwards deleted messages
Anti-Link	.antilink on	Removes links posted by non-admins
Anti-ViewOnce	ANTIVV=true	Opens & forwards view-once media to owner
Anti-Fake	.antifake	Blocks unrecognized country codes
Anti-Demote	.antidemote	Re-promotes demoted admins
Anti-Flood	.antiflood	Per-group flood protection
Anti-Spam	.antispam	Pattern-based spam removal
Anti-Bot	.antibot	Blocks other bots in group

🎵 Media & Downloads

Command	Description
.play / .music	Search YouTube → send as MP3
.ytmp3 <url>	Download YouTube audio
.ytmp4 <url> / .yt	Download YouTube video
.tiktok / .tt	TikTok video (no watermark)
.instagram / .ig	Instagram reels & posts
.facebook / .fb	Facebook videos
.download / .dl	Universal public downloader for YouTube, TikTok, Instagram, Facebook, and X
.autodl on/off/status	Auto-detect public social links and send MP4 plus MP3
.imdb <title>	Search IMDb titles, years, types, cast, and links
.mp4reverse / .slowmo	Reverse or slow down a replied video
.spectrum / .mp3crusher	Create an audio spectrum video or apply an audio effect
.x2mp4 / .x4mp4	Resize a replied video to 50% or 25%
.mp4image	Convert a replied image into a short MP4
.lyrics	Song lyrics
.apk	Download APK from Play Store

🤖 AI & Smart Tools

Command	Description
Silva, ... / .silva / .ask / .ai	Prefix-free or command-based AI assistant with persistent memory
.autopilot / .agent2	Agent v2 with tools, memory, web lookup, weather, and multi-step actions
.tts	Text-to-speech (19+ languages)
.translate	Translate to any language
.textmaker <text>	Create styled Unicode text; aliases include .writetext and .logomaker
.weather	Real-time weather
.wiki	Wikipedia search
.qr	Generate QR code
.calc	Calculator

Any command can show its usage with either .help <command> or <prefix><command> help, for example .translate help or .imdb help.

👥 Group Management

Command	Description
.kick / .remove	Remove a member
.promote / .demote	Change admin status
.warn	Issue warning (auto-kick at 3)
.warnlist	List warnings for the current group
.unwarn / .warnreset / .resetwarn	Reset a member's warnings
.warnmenu / .warnings / .menu 26	Open the Warning Management menu
.tagall	Mention all members
.hidetag	Silent mention
.lock / .unlock	Toggle who can send messages
.welcome / .goodbye	Auto-messages for join/leave
.poll / .vote	Create a WhatsApp poll
.groupvcf / .vcfgroup	Export group members as a VCF contact file
.vcfrows	Reply to a VCF file and list one contact per line
.approveall on/off	Automatically approve or pause group join requests
.approveall status / .joinrequests	Show approval mode and pending requests
.approvejoin all / .rejectjoin all	Approve or reject pending requests in bulk

🎮 Games & Fun

Command	Description
.rps	Rock Paper Scissors
.hangman	Hangman word game
.ttt	Tic-Tac-Toe
.trivia	Trivia question
.8ball	Magic 8-ball
.joke / .dadjoke	Random jokes
.quote	Inspirational quotes

👑 Owner Commands

Command	Description
.ban / .unban	Ban users from bot
.broadcast / .bc	Send to all chats
.eval	Run JavaScript live
.settings	View all settings
.theme / .settheme	Change bot theme
.restart	Restart the bot
.sudo add/del/list	Manage sudo users

---

🎨 Themes

Change anytime with .settheme <name> or set THEME=<name> in your config.

---

🤝 Connect With Silva

---

👨‍💻 Built By

---

🌍 Community

---