Skip to content
Heavstal Docs

Verselor-V1

VERSELOR-V1 BY HEAVSTAL TECH™

  

[!NOTE] This is a beta release. Bugs may occur

TABLE OF CONTENTS

Section titled “TABLE OF CONTENTS”

BOT INFO

Section titled “BOT INFO”

┣ Name: Verselor V1
┣ Description: A high-performance and feature-rich WhatsApp assistant by Heavstal Tech. Verselor V1 supports cross-device connectivity, shared user hosting, and global language translation, offering a complete suite of tools for chat moderation, media processing, and interactive entertainment.
┣ Version: 1.3.6-beta (v1-beta - Latest)
┣ Maintained: [ YES ]
┣ Developer: HEAVSTAL TECH
┣ Language: _English(en - Default)
┣ Total Commands: 600+ (as of Sat 04, April, 2026)
┣ Created On: January 10th, 2026
┣ Prefix: [ . ]
┣ Menu Style: v1
┣ Thumbnail: HERE
┣ HT API KEY: GET HERE
┣ Public Mode: On
┣ Sleep Mode: Off
┣ Group Only: Off
┣ Private Only: Off
┣ StartUp Message: On
┣ Auto React: Off
┣ Auto Record: Off
┣ Auto Typing: Off
┣ Auto Read: Off
┣ Auto RecordType: Off
┣ AutoView Status: Off
┣ Auto Bio: Off
┣ Warn Limit: 3
┣ Anti-Bug/Virus: On
┣ Time Zone: Africa/Lagos

Quick 30 Seconds Start

Section titled “Quick 30 Seconds Start”
git clone https://github.com/HeavstalTech/Verselor-V1.git
cd Verselor-V1
npm install
npm start

Continue Reading Below For More Info On What Verselor Is:

NOTABLE FEATURES

Section titled “NOTABLE FEATURES”

  1. ➭ pair || connect (Multi-Tenancy): Verselor V1 WhatsApp bot offers something different with its Multi-Tenancy system (pair command) which gives it its Multi-Tenant Feature - This command allows a user to connect multiple users to the bot, each with their own instance of the bot, all managed under one server & a single process (“Usage: .pair || .pair 234xxxx”)

  2. ➭ verselor || botai (AI Advancement): One of Verselor V1’s most notable command is the verselor/bot-ai/boatai/bai command, categorized as Verselor V1’s most useful feature - known for it’s expertise on the verselor-v1 bot and it’s ability to run most of the bot’s commands. It’s useful for easy control over the bot. (you can give it a try after deployment - Just Type: “verselor, pull up the bot’s menu for me.”)

  3. ➭ setlanguage || setlang (Multilingual System): As generally known, many WhatsApp bots out there are only assigned to one language, making it difficult for users who don’t understand that language to use the bot - Verselor V1 has addressed this issue by importing a “Multilingual” system that address users to their general language by their set timezone or set language with the “setlang/setlanguage” command - This command is designed to help Non-English users. (“Usage: .setlang fr || .setlang french”)

Verselor V1 solves some problems that many other bots don’t.
Basically User → WhatsApp → Baileys → Command Handler → Plugin System → Response

COMMAND CATEGORIES

Section titled “COMMAND CATEGORIES”

This Bot is stacked with commands ranging from Group, Tools, AI, Fun, Game etc. see the list below for list.

Command Categories

Click on any category below to expand and see the most useful commands!

Helpers & AI
  • .botai - Talk to the bot's internal expert AI (can execute commands for you).
  • .gpt4 / .gemini - Chat with highly advanced AI models.
  • .gimage - Generate AI images from a text prompt.
  • .tr - Translate any text to English.
  • .menu - Display the full, complete list of commands.
  • .ping - Check the bot's latency and server RAM stats.
Group Management
  • .add / .kick - Instantly add or remove members (supports country code mass-kick).
  • .promote / .demote - Grant or revoke admin privileges.
  • .mute / .unmute - Lock or unlock the group chat.
  • .tagall / .hidetag - Mention everyone in the group.
  • .group-events - Toggle automatic welcome/leave/promote notifications.
  • .linkgroup - Fetch the group's invite link.
Owner Only Commands
  • .public / .self - Toggle whether the bot responds to everyone or just you.
  • .banchat / .ban - Blacklist a specific group or user from using the bot.
  • .setprefix / .setbotimg - Customize the bot's prefix and menu thumbnail.
  • .addsudo / .delsudo - Give special moderator access to trusted friends.
  • .update - Automatically pull the latest code from GitHub and restart.
  • .restart / .shutdown - Manage the bot's server process.
Tools & Utilities
  • .sticker - Convert any image, video, or GIF into a WhatsApp sticker.
  • .tourl - Upload a media file to the cloud and get a shareable link.
  • .remini / .hd - Upscale and enhance the quality of blurry images.
  • .tts - Convert your text into a voice note (Text-to-Speech).
  • .ss - Take a high-quality screenshot of any website.
  • .detect - Analyze text to check if it was generated by AI.
  • .vv - Expose and save "View Once" media.
Downloaders
  • .play / .video - Download high-quality audio or video from YouTube.
  • .tiktok - Download TikTok videos without the watermark.
  • .instagram / .twitter - Download Reels, videos, and images from IG/X.
  • .mediafire / .gdrive - Extract and download files directly from cloud links.
  • .apk - Search for and download Android apps.
Fun & Anime
  • .meme / .joke - Get a random funny meme or programming/dad joke.
  • .couple / .soulmate - Randomly "ship" two members in a group chat.
  • .waifu - Get random aesthetic anime waifu pictures.
  • .cry / .hug / .pat - Send animated anime reaction stickers to friends.
  • .pickupline - Generate a cheesy pickup line/rizz.
  • .fact - Learn a random fun fact, math fact, or science fact.
Games & Economy
  • .math / .emojiquiz / .trivia - Quick chat games to earn virtual money.
  • .wordchain - Start a hardcore word-chain game with the group.
  • .tictactoe - Play Tic-Tac-Toe against another group member.
  • .daily / .work - Claim your daily reward or work a job for cash.
  • .gamble / .rob - Risk your wallet to double your money or steal from a friend.
  • .bal / .lb - Check your wallet balance and view the richest users leaderboard.

LIVE DEMO

Section titled “LIVE DEMO”

This gif shows a live demo of this bot executing the “menu” command

Live Demo

[!IMPORTANT] Fork this repository Also star to support the developers of this bot and promote popularity

CLOUD DEPLOYMENT

Section titled “CLOUD DEPLOYMENT”

Important Note: After clicking Deploy, copy and go to the given link provided by the service, wait about 5-7 minutes (if it’s a fist-time build), a website dashboard will appear, enter your AuthCode & WhatsApp Number and click deploy, you’ll receive a 8 digit code in less than a minute, Go to WhatsApp → Linked Devices → Link a Device → Link with phone number & Enter the code.

While Using Render Verified Status

Section titled “While Using Render ”

Deploy to Render

While Using Replit
Verified Status

Section titled “While Using Replit ”

Run on Replit

While Using Heroku
Verified Status

Section titled “While Using Heroku ”

Deploy
Note: Heroku deployment now natively uses the Docker container stack via heroku.yml. No manual buildpacks are required.

While Using Koyeb
Verified Status

Section titled “While Using Koyeb ”

Deploy to Koyeb
Note: Koyeb will automatically detect the Dockerfile and build the bot. Once deployed, open your Koyeb App URL to access the Control Panel and pair your number.

While Using TalkDrove Verified Status

Section titled “While Using TalkDrove ”

**Note:** _Create an account, link your GitHub, select your forked Verselor-V1 repository, and deploy using the Node.js/Docker environment._ ---

WEB PANEL DEPLOYMENT Verified Status

Section titled “WEB PANEL DEPLOYMENT ”

For users using panels like Pterodactyl, Discord Hosting Sites, or cPanel.

Method 1: Using Pair Code

Section titled “Method 1: Using Pair Code”
  1. Download the complete code as a ZIP file.
  2. Upload the file to your Node.js server/panel.
  3. Unzip & Enter The “Verselor-V1-main” folder, select all files and move them to the root directory ../.
  4. Set the Node version of your hosting environment to version 20x or later (Recommended).
  5. Navigate to your server console and start the deployment (Click Start or run npm install && npm start).
  6. Wait approximately 2 minutes for dependencies to install.
  7. When prompted in the console, input your WhatsApp number (Country Code + Number).
  8. When prompted for AuthCode, Enter your authcode wait for it to verify (don’t have an AuthCode? Get Here)
  9. A Code will appear. Go to WhatsApp → Linked Devices → Link a Device → Link with phone number & Enter the code.

Method 2: Using QR Code

Section titled “Method 2: Using QR Code”

Verified Status

  1. Fork This Repo
  2. Navigate to the root directory and find the .env file and click.
  3. Click the pencil icon (Edit) and change USE_PAIR_CODE to false

Exmaple:

USE_PAIR_CODE=false
  1. Follow steps 1-5 from above (Upload, Unzip, Start).
  2. A QR Code will appear in the console.
  3. Go to WhatsApp → Linked Devices → Link a Device and scan the QR code.

[!TIP] Verified Status
If you’re deploying on panels like Katabump, interactive typing might not work. Do this instead:

  1. Fork This Repo
  2. Navigate to the root directory and find the .env file and click.
  3. Click the pencil icon (Edit) and add your WhatsApp Number and AuthCode.

Example:

USE_PAIR_CODE=true
WHATSAPP_NUMBER=2348166546725
AUTH_CODE=Heavstal_Bots_Your-46-Digit-Code-Here...
  1. Commit changes.
  2. Follow the deployment steps from METHOD 1. The bot will automatically read the file and skip the terminal prompts!

Local Deployment Service Recommendations

Section titled “Local Deployment Service Recommendations”
  1. Deploy On Katabump - follow the steps HERE
  2. Deploy on Bot-Hosting - follow the step HERE
  3. Deploy on WispByte - follow the steps HERE

COMMAND LINE INSTALLATION (Termux/VPS) Verified Status

Section titled “COMMAND LINE INSTALLATION (Termux/VPS) ”

Requirements

Section titled “Requirements”

For Termux Users

Section titled “For Termux Users”

Note: Do not download Termux from the Play Store. Download it from F-Droid Here.

  1. Update System & Install Dependencies:
Terminal window
apt update && apt upgrade -y
pkg install git nodejs ffmpeg imagemagick libwebp -y
  1. Clone Repository:
Terminal window
git clone https://github.com/HeavstalTech/Verselor-V1.git
cd Verselor-V1
  1. Install & Start:
Terminal window
npm install
npm start

Follow the prompts in the terminal to enter your number and authcode to get the Pairing Code.

For VPS / Ubuntu / Linux

Section titled “For VPS / Ubuntu / Linux”
Terminal window
sudo apt update && sudo apt upgrade -y
sudo apt install git nodejs ffmpeg imagemagick libwebp -y
git clone https://github.com/HeavstalTech/Verselor-V1.git
cd Verselor-V1
npm install
npm start

FOR DEVELOPERS & CONTRIBUTORS

Section titled “FOR DEVELOPERS & CONTRIBUTORS”

Verselor-V1 utilizes a highly modular ECMAScript Module (ESM) plugin architecture, making it seamless for developers to create independent commands and tools without modifying the core engine.

Community contributions are strictly welcomed and encouraged. If you have engineered a custom plugin, patched a bug, or optimized existing logic, please consider submitting a Pull Request.

Tech Stack

Section titled “Tech Stack”
  1. NodeJs (ES Module)
  2. Docker (Cloud Deployment)
  3. Html & Css (Web UI - Cloud Deployment)
  4. Baileys (Maintained Fork)
  5. LowDb (Json Storage)

FAQ (Frequently Asked Questions)

Section titled “FAQ (Frequently Asked Questions)”
1. What Is Verselor-V1? Verselor-V1 is a high-performance and feature-rich WhatsApp assistant by Heavstal Tech. Verselor V1 supports cross-device connectivity, shared user hosting, and global language translation, offering a complete suite of tools for chat moderation, media processing, and interactive entertainment.
2. How Do I Become A Premium User? You can become a premium user by following the steps below: > 1. Go to [Heavstal Bots AuthCode Manager Page](https://heavstal-bots.vercel.app/dashboard/manager) > 2. Enter your active AuthCode in the input box that says "Heavstal_Bots_..." > 3. Select The Premium Button/Tab with Golden Outline > 4. Select the amount of days you want to stay premium (3d/7d/14d/30d/custom) > 5. Click the "Upgrade To Premium" button > 6. Restart The Bot.
3. Will my WhatsApp account get banned for using this? Using unofficial WhatsApp APIs always carries a small risk. To minimize this, do not spam groups, turn off startup messages, and preferably use a secondary/burner number to host the bot.
4. How do I make myself the owner of the bot? Due to the bot's settings, you are already an owner by default. However, you can add other people as owners/sudos so they have the same privileges as you by using the .addowner or .setsudo command.
---

ISSUES

Section titled “ISSUES”

If you have any issues with the bot - use any of the methods below to get it resolved.

  1. Open A GitHub Issue
  2. Submit the issues and screenshot (if possible) to the bot support WhatsApp Group
  3. Alternatively submit to the bot’s Telegram Support Group

Join Our Channels To Stay Updated Recommended

Section titled “Join Our Channels To Stay Updated ”



Buy Me A Coffee / Donate

Section titled “Buy Me A Coffee / Donate”

Join Our Bot Support & Group Chats Recommended

Section titled “Join Our Bot Support & Group Chats ”

[!CAUTION] Verselor-V1 is not made by WhatsApp Inc. Misusing the bot might ban your WhatsApp account!* - In Such Scenarios, Heavstal Tech is not responsible for the banning of your account. - Use Verselor-V1 at your own risk by keeping this warning in mind.
To reduce the risk of this slightly:

  • Consider turning off startup messages in with the command after deployment…

License

Section titled “License”

This project is licensed under the Custom / Heavstal Tech™ End User License Agreement (EULA).

Please see LICENSE for further information (Essential)

Section titled “Copyright Notice:”

You may acquire any open-source part of this WhatsApp Automation Bot for free. By acquiring an open-source copy of this bot, you are by default bound to the Copyright Notice of this project, which strictly states that you must give proper credit to Heavstal Tech™.

Note: Some core files are obfuscated to protect proprietary API keys and prevent scraping. Many plugins remain fully open for developers to customize.

CHANGE NOTICE:

Section titled “CHANGE NOTICE:”

The contents of this file may change occasionally, it’s important to check every onces in a while and occasionally see CHANGELOG.md for changes made to the bot.

© A Product Of Heavstal Tech™