Loading...
HT Logo
Back to Dashboard

Verselor-V1

A Powerful, Lightweight, Multi-Device, Multifunctional, Multi-Purpose, & Multi-Tenant WhatsApp bot, built by Heavstal Tech. 2026

Source Download

VERSELOR-V1 BY HEAVSTAL TECH™

  

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

📑 TABLE OF CONTENTS

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.2.1-beta.1 (v1-beta - Latest)

┣ Maintained: [ YES ]

┣ Developer: HEAVSTAL TECH

┣ Language: _English(en - Default)

┣ Total Commands: 670+ (as of Sat 04, April, 2026)

500+ functional commands across multiple categories.

┣ Created On: January 10th, 2026

┣ Prefix: [ . ]

┣ Menu Style: v1

┣ Language: _English(en - Default)

┣ 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

git clone https://github.com/HeavstalTech/Verselor-V1.git  
cd Verselor-V1-main  
npm install  
npm start

Continue Reading Below For More Info On What What Verselor Is:

NOTABLE FEATURES

  1. ➭ pair || connect (Multi-Tenancy):
    While some WhatsApp Bots out there only grants a "one user - one instance" system, 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

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

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

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

Deploy to Render

While Using Replit
Verified Status

Run on Replit

While Using Heroku
Verified Status

Deploy



BUILDPACKS:

  1. heroku/nodejs
  2. https://github.com/jonathanong/heroku-buildpack-ffmpeg-latest.git
  3. https://github.com/clhuang/heroku-buildpack-webp-binaries.git

While Using Koyeb
Verified Status

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


**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

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

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

  1. Open settings/config.js and set usePairingCode to false.

    EXMAPLE:
    Before (Default):
let _usePairingCode = process.env.USE_PAIR_CODE !== undefined ? (process.env.USE_PAIR_CODE === 'true') : true; // True For Pair Code // False For Qr Code

After (Changed to QR Code - Copy & Paste):

let _usePairingCode = process.env.USE_PAIR_CODE !== undefined ? (process.env.USE_PAIR_CODE === 'true') : false; // True For Pair Code // False For Qr Code

Alternatively, as a casual user, you can completely delete all the complicated environment variable stuff and just hardcode it like this (Copy & Paste):

let _usePairingCode = false; // True For Pair Code // False For Qr Code
  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 Katabump, you must:

  1. Fork This Repo
  2. Navigate To Settings Folder and enter the config.js file
  3. Click the three dots (...) --> Edit In place
  4. Add your WhatsApp Number to the place that says _phoneNumber, add it in between the "" in country code format

Exmaple:
Before (Default):

let _phoneNumber = process.env.WHATSAPP_NUMBER || "";      // Enter your WhatsApp number here (Optional)

After Adding your Number (replace "234xxx" with your actual WhatsApp number and country code without "+" - Copy and paste)

let _phoneNumber = process.env.WHATSAPP_NUMBER || "234xxx";  // Enter your WhatsApp number here (Optional)

Alternatively you can do (replace "234xxx" with your actual WhatsApp number and country code without "+" - Copy and paste):

let _phoneNumber = "234xxx";  // Enter your WhatsApp number here (Optional)
  1. Commit changes... - Commit Change
  2. Follow All The Steps from METHOD 1

Local Deployment Service Recommendations

  1. Deploy On Katabump - follow the steps HERE
  2. Deploy on Bot-Hosting - follow the step HERE

💻 COMMAND LINE INSTALLATION (Termux/VPS) Verified Status

Requirements

For Termux Users

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

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

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

For VPS / Ubuntu / Linux

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-main
npm install
npm start

Adding Custom Plugins

👨‍💻 For Developers

Adding a custom command to Verselor-V1 is incredibly simple thanks to its modular ESM structure.
Just create a new .js file inside any folder in Start/Plugins/ (e.g., Start/Plugins/custom/mycmd.js) and paste the following template:

export default [
    {
        name: 'mycmd',
        aliases: ['cmd1', 'cmd2'],
        category: 'misc',
        description: 'A simple custom command',
        usage: '%prefix%mycmd',
        ownerOnly: false, // "true" to restrict to owners and sudos only
        groupOnly: false, // "true" to set to group only command 
        privateOnly: false, // "true" to set to private chat only (non groups) command
        adminOnly: false, // "true" to set to admin only command in groups
        botAdminOnly: false, // "true" to make only useable if bot is admin in group
        premiumOnly: false, // "true" to set to premium users only command.

        execute: async (HeavstalTech, m, context) => {
            // The context object provides easy access to variables and helper functions
            const { Vreply, pushname, prefix } = context;
        /** 
        `context` provides you with the following:
    
        text, q, args, prefix, command, budy,
        isOwner, isCreator, isAdmin, isBotAdmin, isGroup, isPremium,
        pushname, BotNum, sender, from,
        quoted, mime, isMedia, fatkuns,
        Vreply, reply, sendImage,
        participants, groupName, groupMetadata,
        MenuStyle, time, todayDateWIB,
        Owner, setsudo, ban, BANNED_GROUP,
        store, chatUpdate,
        loading, sendMenu, followNewsletter, autoJoinGroup, Styles,
        channelIds, ReplyImageUrls, promiseplay_url
        **/     
            // Your command logic here
            await Vreply(`Hello ${pushname}! You just used the ${prefix}mycmd command.`);
           // Alternatively use `HeavstalTech.sendMessage()`
        }
    }
];

Save the file, restart the bot, and your command will automatically be loaded into the system and added to the menu or alternatively use the addplugin command in the bot after deployment.

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)

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

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

PULL REQUESTS & COLLABORATIONS

If you add a custom plugin that you feel should be in the bot - follow the step below to add it to Pull Request (PR) and become a collaborator:

  1. Fork the repo
  2. Add your custom plugins in a folder called Custom (create it if unavailable)
  3. Submit A Pull Request (usually at the top of a repo)

Join Our Channels To Stay Updated Recommended



Buy Me A Coffee / Donate

Join Our Bot Support & Group Chats Recommended

[!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

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

Please see LICENSE for further information (Essential)

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:

The contents of this file mau 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™