/HellBot

A turbocharged telegram userbot written in python 🚀❤️

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

тнє нєℓℓвσт

The HellBot

🚀 Telegram Bot on Steroids!

Packed with the latest commands, limitless features, etc.
Unleash the ultimate power of customization and automation like never before!


GitHub forks GitHub Repo stars

Maintenance GitHub license

Python Documentation

Telegram Group Telegram Channel

Subscribers Views


Deploying HellBot on Heroku

Follow these 4 straightforward steps to deploy HellBot on Heroku:

  1. Fork & Star this Repo:

    Begin by forking and starring this repository on GitHub.

  2. Heroku Account Login:

    Ensure you are logged into your Heroku account before proceeding.

  3. Click "Deploy to Heroku":

    Find the "Deploy to Heroku" button below, and click it, but make sure you are deploying from your fork.

  4. Fill Required Variables:

    On the deployment page, you'll find necessary variables to be filled out.

That's it! You've successfully deployed HellBot on Heroku. Now scale dynos and start the bot!


Deploying HellBot on Linux

Hellbot can be deployed on any Linux VPS and terminal.

  1. Update Packages:

    sudo apt update && sudo apt upgrade -y
  2. Install required packages:

    sudo apt install --no-install-recommends -y python3 python3-dev python3-pip python3-virtualenv git mediainfo nano ffmpeg unzip tmux
  3. Clone Github repository:

    git clone https://github.com/The-HellBot/Plugins HellBot && cd HellBot
  4. Edit Config Variables:

    cp example.env .env && vi .env

    Now press 'i' on your keyboard to start editing the .env file.

    Now fill all the env mentioned in the file.

    To save the file press 'Esc' button and write ':wq' using your keyboard and press 'Enter'

  5. Install Requirements:

    Create an virtualenv and source it.

    python3 -m virtualenv venv && source venv/bin/activate

    Now install requirements but make sure you're in (venv)

    pip3 install -U -r requirements.txt
  6. Start the Bot:

    Start a sub-terminal using tmux

    tmux new-session -s hellbot

    Now start the bot

    ./start.sh

    Not press 'Ctrl + B' then 'D' to detatch from tmux and let your bot run in background.

That's it! You've successfully deployed HellBot on a Linux VPS in 6 easy steps.


Config Variables

  • API_HASH : Get this value from my.telegram.org

  • API_ID : Get this value from my.telegram.org

  • BOT_TOKEN : Get this value from @Botfather

  • DATABASE_URL : Get this value from mongo.db

  • LOGGER_ID : A group/channel id to use as a logger chat.

  • OWNER_ID : The owner of bot. Only single userid is supported.

More config details coming soon with updated documentations


Disclaimer

  • Our team disclaims responsibility for any consequences to your Telegram account. If issues arise due to misuse or conflicts, accountability rests with the user. The bot serves for recreational purposes and aims to streamline group/profile management. User-caused account issues are beyond our purview.

  • While forking the repository is permitted, we won't support edited plugins or modifications. Responsibility for further updates lies with individual forkers.

  • This service does not provide individualized support. Should you require assistance, kindly engage with our support group for community-based guidance.

Thank you for choosing our bot and for your understanding and adherence.

~ Team HellBot ❤️


License

HellBot License

Copyright (C) 2024 The-HellBot

Project HellBot is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.


Made with ❤️ by Anand