Raganork-MD

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

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

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

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

Install Dependencies

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

npm start

Process Management

# 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

Legal Notice

⚠️ 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.

raganork-md

Description

README