Skip to content

README.md

Latest commit

 

History

History
205 lines (144 loc) · 5.42 KB

README.md

File metadata and controls

205 lines (144 loc) · 5.42 KB

Stars Forks

A Group Manager Bot built with Pyrogram + MongoDB for managing Telegram groups

🔗 Official Nomade Links

This repository contains the basic open-source edition of Nomade Help Bot.
For the fully upgraded & officially maintained version, use the links below.

⚠️ This repository may not always include the latest features or security updates available in the official bot.

⭐ Features

  • Owner Command: /broadcast, /stats
  • Group Moderation: kick, ban/unban, mute/unmute, warn, warns, resetwarns, promote/demote
  • Auto Welcome System with placeholders ({username}, {mention}, etc.)
  • Dynamic Start Message with text, image, and inline buttons
  • MongoDB Storage for data persistence
  • Beautiful Inline UI and modular codebase

---------------------

🔸 Free Hosting

We are going to host this bot on Render. To deploy it, we need to change a few codes, so watch the tutorial properly before deploying.

Watch Tutorial

  

🔸 Deploy on VPS / Localhost

1. Fork & Star ⭐

  • Click Fork (top-right of GitHub repo)
  • Then click Star ⭐ to support this project!

2. Get Your Fork URL

https://github.com/<your-username>/NomadeHelpBot.git

3. Setup Your VPS

Install system packages:

sudo apt update && sudo apt upgrade -y
sudo apt install -y git python3 python3-pip python3-venv tmux nano

4. Clone Your Fork

git clone https://github.com/<your-username>/NomadeHelpBot.git
cd Nomade
python3 -m venv venv
source venv/bin/activate

5. Install Dependencies

pip install --upgrade pip && pip install -r requirements.txt

6. Configure the Bot

nano .env

⚙️ required fields

# Telegram API
API_ID=
API_HASH=
BOT_TOKEN=

# MongoDB
MONGO_URI=
DB_NAME=Cluster0

# Owner and Bot Info
OWNER_ID=
BOT_USERNAME=NomadeHelpBot

# Links & Visuals
SUPPORT_GROUP=https://t.me/LearningBotsCommunity
UPDATE_CHANNEL=https://t.me/LearningBotsOfficial
START_IMAGE=https://files.catbox.moe/j2yhce.jpg

✅ Save with: Ctrl + O, then Enter
❌ Exit with: Ctrl + X

7. Run the Bot

tmux new -s groupbot
source venv/bin/activate
python3 main.py

➡️ Detach (keep it running): Ctrl + B, then D

---------------------

📱 Connect with Me

⚠️ License / Usage Terms

This project is open-source under a custom license by Yash.

✅ You Can:

  • Use this code for personal or educational purposes
  • Host your own version with proper credits
  • Modify or improve the code (while keeping credit intact)

🚫 You Cannot:

  • Remove author credits or change project name
  • Sell, rent, or resell this code or any modified version
  • Claim ownership or re-upload it without permission

If you want to use this project commercially,
please contact the author at LearningBotsOfficial.

Author: LearningBotsOfficial
Support Group: @LearningBotsCommunity
Update Channel: @learning_bots
YouTube: Learning Bots

---------------------

Buy Me a Coffee