GitPedia

Raganork md

A light-weight multi-functional WhatsApp bot framework.

From souravkl11·Updated June 15, 2026·View on GitHub·

A lightweight WhatsApp bot framework with multi-session support and extensive configuration options. Complete rewrite of the original Raganork project for better stability and performance. The project is written primarily in JavaScript, distributed under the GNU General Public License v3.0 license, first published in 2021. It has gained significant community traction with 1,087 stars and 1,901 forks on GitHub. Key topics include: raganork, whatsapp-bot.

Raganork-MD

<p align="center"> <a href="https://rgnk.site"> <img src="https://i.ibb.co/QL4BQQ6/Untitled-1.png" alt="Get Session" width="300"/> </a> </p>

A lightweight WhatsApp bot framework with multi-session support and extensive configuration options. Complete rewrite of the original Raganork project for better stability and performance.

Get Started

1. Get Your Session String

<p align="center"> <a href="https://rgnk.site"> <img src="https://i.ibb.co/fVWcycPc/get-session.png" alt="Get Session" width="200"/> </a> </p>

Important for Cloud Deployments: If you're deploying on platforms like Render, Koyeb, Railway, or similar cloud services, you'll need a DATABASE_URL (PostgreSQL) for persistent storage. VPS deployments can use local file storage.

2. Deploy and setup your bot

<p align="center"> <a href="https://rgnk.site"> <img src="https://i.ibb.co/fVsfPsjk/deploy-bot.png" alt="Get Session" width="200"/> </a> </p>

Features

  • Lightweight and fast performance
  • Single and multi-session capabilities
  • Extensive plugin system
  • Group management tools
  • Media download functionality
  • Excellent caching and session management

Prerequisites

  • Node.js (version 20 or higher)
  • Git
  • FFmpeg
  • Yarn package manager
  • PM2 (for process management)
  • Database URL (postgreSQL - for cloud deployments)

Installation

Clone Repository

bash
npm install -g yarn pm2 git clone https://github.com/souravkl11/raganork-md.git cd raganork-md

Install Dependencies

bash
yarn install

Configuration

Create a .env file in the root directory:

Session Configuration

Single session:

SESSION=RGNK~d7a5s66

Multi-session:

SESSION=RGNK~d7a5s66,RGNK~7ad8cW

Required Variables

# Bot Configuration
BOT_NAME=Your Bot Name
HANDLERS=.,!
SUDO=919876543210

# Database (Required for cloud platforms)
DATABASE_URL=your_database_url

# Localization
LANGUAGE=en
TZ=Asia/Kolkata

Running the Bot

bash
npm start

Process Management

bash
# Stop bot pm2 stop raganork-md # Restart bot pm2 restart raganork-md

Commands

Default prefix: .

  • .list – Show available commands
  • .ping – Check response time
  • .restart – Restart bot (sudo only)
  • .shutdown – Stop bot (sudo only)

File Structure

raganork-md/
├── plugins/     # Bot plugins
├── core/        # Core libraries
├── output/      # Operational outputs
├── temp/        # Temporary files
├── config.js    # Configuration handler
├── index.js     # Main entry point
└── package.json # Dependencies

Support

⚠️ Use at your own risk. This bot uses unofficial WhatsApp Web API methods and may result in temporary or permanent account bans.

  • This code is in no way affiliated, authorized, maintained, sponsored or endorsed by WhatsApp or any of its affiliates.
  • WhatsApp is a trademark of WhatsApp Inc., registered in the U.S. and other countries.
  • This software is provided for educational and research purposes only
  • Powered by Baileys

License

GPL License - See LICENSE file for details.


Note: Some files are obfuscated for security reasons and should not be modified.

Contributors

Showing top 1 contributor by commit count.

View all contributors on GitHub →

This article is auto-generated from souravkl11/raganork-md via the GitHub API.Last fetched: 6/17/2026