Raganork md
A light-weight multi-functional WhatsApp bot framework.
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
bashnpm install -g yarn pm2 git clone https://github.com/souravkl11/raganork-md.git cd raganork-md
Install Dependencies
bashyarn 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
bashnpm 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
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.
Contributors
Showing top 1 contributor by commit count.
